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Introduction 


This manual contains all the current deatils of pripherals for the 
Amstrad 464, 664 and 6126 computers that are available from DK'tronics, 


All peripherals are supplied with comprehensive software in cassette, 
disc or ROM format and are usually controlled through BASIC via Resident 
System Extensions, (CREX's), As such the new commands are preceeded by 
the (BAR3 {| symbol which is obtained by pressing the <SHIFT> key 
tagether with the @ key, 


Throughout this manual all command key entries are shown enclosed in the 
symbols < >, ia <ENTER?, 


The command keys are given as follows :- 


SENTER? 
<CLR> 

<CTRL> 
<SHIFT> 
“COPY > 


<TAE> 
All text, numeric entries are inclased within the symbols ' ', ie type 
in ‘tlightpen', 


If the user is required to enter values for the RSX commands then these 
are enclosed in the brackets € 1, 


When ever the user is raquired to enter data for the various RSX's then 
the syntax is as given in the example below;- 


{savew,€ window number 3,f bank J 

Therefore the user would actually type in the fallowing:— 
press <SHIFT? together with the @ key ,to obtain the (bar? symbol, 
then type in 'savew,5,2' then prass <ENTER> 


where window number = 5 and bank = 2 
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GRAPHICS LIGHT PEN 


The DK‘trenics graphics lightpen is compatible with the GT64 * CTM646 * 
MP1 and DDE 1 interfaces, 


It is supplied with a sophisticated graphics package in both cassette 
and ROM versions, 


Features include;- 


colour palette 

‘nudge’ control for 1 pixel accuracy 
brush choice 

text handling 

user defined sprites 

magnify 

shrink 

circles 

rectangles 

lines 

curves 

colour fill 

tape and disc facilities 
picture storage and retrieval 
pen calibration utility 
printer dump 
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GRAPHICS | IGHTPEN MANUAL 


WARNING 


This unit must be used in accordance with these instructions, Never plug 
in or remove the interface without first disconnecting the power from 
the computer, Failure to follow these instructions may result in damage 
to the interface or the computer, 


1,1 INSTALLATION 


Ta set up your Graphics Lightpen, TURN OFF THE POWER TO YOUR AMSTRAD, 
then plug the interface into the disc port on the CPC 464 or the 
expansion port on the CPC 664/6128, If you have a disc drive (464) then 
Fit the disc drive interface onto the back of your lightpen via the 
through connector, Attach the lightpen itself to the jack socket on the 
laft side of the interface, 


The OK'Tronics Graphics Lightpen is compatible with the Amstrad disc 
drive (DDI-1) and the DK'Tronics speech unit, and any combination of the 
three can be used, 


Now turn on your computer, The computer should initialise normally, If 
if does not, switch off the power to the computer by the switch on the 
monitor and check that all the connections have been made correctly, 
Now switch on again, Oue to the construction of the monochrome monitor, 
you may have to wait a short while before switching on while the monitor 
resets power to the computer, this is quite normal, 


1,2,1 SOFTWARE LOADING DETAILS (cassette) 


Your Graphics Lightpen can be used directly from BASIC or machine-code 
programs of your own, but the graphics package supplied illustrates what 
can be achieved with the lightpen and serves as a useful. demonstration 
of its powers, It is also a powerful program in its own right as shown 
by the artwork on the packaging, which was drawn using the Graphics 
Lightpen, 


To load, simply place the cassette in the tape drive, press <PLAY>, and 
type 'RUN' and press “<ENTER>, The program will now load into the 
computer , 


If you have an Amstrad disc drive attached to your computer then you 
Need to type ‘ITAPE' and press <ENTER>, Now type 'RUN' and press 
<ENTER?, The procedure for loading on the Amstrad 664 is similar except 
you need to attach an external cassette unit before using the above 
instructions, Full instructions on loading tapes may be found in your 
Amstrad manual, 


The tape is recorded on both sides using SPEED WRITE @ and is NOT 
protected, so that users with disc drives may copy the software to disc, 
After four and a half minutes the Graphics Package should have loaded, 


—— 
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1,2,2 SOFTWARE LOADING DETAILS (ROM) 


All that is required to run the ROM software is to type in "Ilightpen" 
then press <ENTER>, 


1,32 RUNNING THE PACKAGE - BASICS 


Once the program is run, the screen will clear to a white background 
with a black border and a menu will appear, A menu is a list of tasks 
which the computer can carry out, Instead of you having to tell the 
computer what to do by using symbols and words (like in BASIC), it 
enables you to select from a certain number of functions, Compare this 
to the menu you might find in a restaurant, The menu saves you having 
to ask for meals which are not available, and reminds you of the kinds 
of dishes that you can have, Similarly when you want the computer to 
draw a circle or edit some screen, you simply select an item from the 
menu, To make the things easier to remember, all the choices are in the 
form of pictures, These express what the function is without using lots 
of text! 


This is the first of several menus which hold up to five choices 
represented as pictures or ‘ikons', Pointing the lightpen to each ikon 
will make a set of white brackets appear around the ikon, This 
indicates which choice you require, When the brackets are around the 
ikon you require, press either <ENTER> key to make your choice, 
Remember to leave the lightpen pointing at the ikon while you press 
<ENTER? , 


If you wish, the selection can also be made by pressing the number keys 
‘1! through to 'S' and then <ENTER>, This is useful for making choices 
before the pen has been calibrated, You can change your mind once you 
have pressed a number key, but you cannot use the lightpen to select an 
ikon again until the next menu appears, Once <ENTER> has been pressed 
your choice is made, however pressing <ESC> will get you back to where 
you were, 


Practice pointing the lightpen at the ikons to make choices and see 
whera you get to! Remember <ESC> will always get you back to the last 
menu, 


When you are familiar with choosing ikons, press <ESC> until the very 
first menu appears on the screen, This is the LOADING and SAVING menu 
and allows you to load and save pictures you have drawn to tape or disc, 
The menu will look different depending on whether you have a disc drive 
attached:- 


PS 
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Disc Connected Tape only 


Load from 
cassette 


Load from 
cassette 


Save to 
cassette 


Load from Save to 


disc cassette 


Save to 
disc 


NEXT 
MENU 


Foint toa the last ikon ‘NEXT' or press 'S', Then press <ENTER>, A new 
menu will appear with just three ikons:- 


Clear the 
Screen 


Calibrate 


Lightpen 


The first ikon will clear the screen's contents and should be carefully 
used! The second allows you to enter the lightpen calibration routine, 
Foint the lightpen at the calibrate ikon and press <ENTER? to confirm 
your choice, 


A target like the ikon itself will appear on the screen, Now hold the 
lightpen up against the screen in the centre, If all is well the target 
will hover directly under the top of the pen, Increase or decrease the 
brightness and/or contrast on your monitor or TV until the target 
follows the pen tc all corners of the screen, For best response hold 
the pen perpendicular to the screen, touching the glass and keep your 
arm well supported to prevent your hand shaking, 


Once you have got the target to follow the pen, reduce the brightness 
until you get best results with minimum brightness, The target may 
‘jitter’ to a greater or lesser degree but this does not matter as you 
will see when using the ‘nudge’ feature, 
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The target may seem to be a short distance away from the tip of the 
lightpen, If so, you can adjust the centre of the pen by using the 
Amstrad's cursor keys;- 


Hold the pen very steady and press the respective directions to move the 
cross under the tip of the pen, Press <ENTER> to record this new 
setting or <ESC> to leave the setting unchanged, You can recalibrate at 
any time during using the program, 


Your lightpen is now fully functional and calibrated, Do not worry if 
it does not seem accurate enough for fine line drawing - using the 
DE'Tranics ‘nudge’ feature the pen can draw as accurately as you wish:— 


The last manu will reappear, Select the ‘NEXT' ikon and press <ENTER> 
to confirm your choice, A new menu will appear:- 


DRAW 
MODE 


FILL 
MODE 


PAINTBOX 


PALETTE 


BRUSH 
SIZE 


NEXT 
MENU 


You are now in the third menu, Pressing “ESC> will make the previous 
menu appear Press <« > again and the first menu will appear, 
Fressing «65C> again will not take you to any further menus, Select 
"'NEXT' toa get into the second menu, then 'NEXT' again to get back to the 
third menu, 


= 
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*% REMEMBER 42% 


Pressing <ESC> whilst a menu is on the screen will take you BACK 
one menu, 


Pressing <ESC> whilst you are performing some action onthe screen 
€eg Calibrating, Drawing) will simply make the current rmenu 


reappear, 
In all cases, selecting ‘NEXT' selects and displays the next msenu, 


There are five main menus and several sub-menus, You now know enough to 
flick through the five menus and back again but do not select any 
function as yet, 


Ga back to the third menu and select the third ikon, a paint palette, A 
paint box will be displayed (differant tones on the monochrome monitor?, 
Use the lightpen ar number keys ¢'1' to ‘'@') to select a colour/tone 
from the box, The paint box is surrounded by a yellow boarder, you can 
use this to select the darker colours by pointing the pen to the border 
next to the reguired colour, 


4% REMEMBER X28 


The Lightpen needs light to work - it will not pick up on dark 
colours or tones, 


Select a bright colour/tone and press <ENTER> ta confirm your choice, 
If you press <ESC> then the colour will remain the same and you will 
return ta the last menu, 


Now select the fourth ikon, the pencil ikon, A menu of pencil sizes 
will appear and you can select any size you want! The bottom ikon is a 
spray can! this produces a splatter effect like an airbrush, Press 
SENTER> to select your pencil 


When you return to the third menu, point the lightpen ta the first ikon 
and press *ENTER> to confirm your choice, You are now in draw mode! 


There should now be a clear screen with a single small cross under the 
lightpen, This cross represents where the computer ‘sees' the lightpen, 
Fressing <ENTER? will draw a blob using the pencil and colour/tone you 
selected, Move the pen around the screen and press <ENTER> again, More 
blobs will appear! If you keep the Large <ENTER> key pressed down, then 
repeated blobs will appear and in this way you can shade in areas of 
screen, 


Now press the space bar, A continuous line will be drawn from the last 
point to the tip of the lightpen, If you are using a thin pencil then 
you can keep the space bar pressed and draw sequence of lines quite 
quickly, If you are using a thick pencil then you may have to move the 
lightpen more slowly, 
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When you are fed up, try pressing <ESC> and changing the colours and 
pencil sizes as outlined beforehand, Also try clearing the screen by 
pressing <ESC> twice and going back to the second menu, 


When you have finished making patterns on the screen using the drawing 
mode, clear the screen then enter draw mode again, Now move the pen to 
the top right hand corner of the screen without pressing any key, Now 
press one of the cursor keys and notice what happens, 


The cross has now halted in one position and can anly be moved by using 
the four curser keys, This is the ‘nudge’ feature which means you can 
move the cross to a single pixel, Pressing <ENTER? or the SPACEBAR 
willstill have the same effect as before, If you press <COPY> then the 
cross will once more nove with the lightpen, Try to draw some shapes by 
maving the cross, pressing <ENTER> then moving the cross to another 
point, use the ‘nudge' feature to move the cross to an exact position 
for Say a square or a triangle, Now press the SPACEBAR to draw a line 
to that point, Finally, use the ‘nudge’ to link the final edge of your 
shape to the starting point, 


1,4 FILLING IN SHAPES 


When you have your shape on the screen you may wish to fill in the 
cantre with a colour/tone, Press <ESC> to re-enter the third menu, 
Then select the secand ikon, the tap! After you press <ENTER>, the menu 
will disappear and the cross will reappear, Move the cross so that it 
is inside the shape and press <ENTER?, If you want to fill in small 
shapes where it is difficult to move the tip of the light pen into the 
centre of the shape, then move the cross close to the shape, then use 
the 'nudge' feature to move the cross into the exact area to be filled, 
Then press ¢ENTER? as before, 


Watch out for shapes which have 'a leak'! Any shape which is not fully 
anclosed will let the ink spill out until it fills the whole screen, 
You can still press <ESC> to stop a fill whilst it is in action, It is 
worth remembering that whatever colour exists at the point where you 
start filling is taken as background colour, Hence you can remove 
objects by filling in a shape with white colour, 


The best way to learn how to use fill is to experiment with lots of 


different shapes drawn in draw mode, then fill them in, Remember to 
change the paint colour and pencil size, You may even like to try and 
fill the outline of a shape, If you use a thick line, then you can 


change the colour of the outline in one fill command, 
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1,5 DRAWING CURVES AND COMPLEX SHAPES 


Select the fourth jmenu:— 


RUBBER BAND 
TO NEW PIN 


OUTLINE LAST 
RUBBER BAND 


PAINTBOX 


PALETTE 


PENCIL 
SIZE 


NEXT 
MENU 


For drawing complex shapes or curves, the software makes use of ‘rubber 
bands' stretched between ‘drawing pins', For instance, a curve can be 
considered as a series of short lines:- 


Qr avan;- 
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The Graphics package allows you to define a shape on the screen using 
one rubber band and up to twenty drawing pins, This feature is most 
useful because just as real drawing pins can be removed, so can the 
imaginary computer drawing pins, 


Once you are happy with the shape you fave drawn, the computer removes 
the rubber band and pins then outlines the shape in the current pencil 
and colour/tone, 


Go back to the second menu and clear the screen, Then return to this 
menu and select the first ikon, Press <ENTER> to confirm your choice, 
& cross like the one used in draw and fill mode will appear in’ the 
bottom left of the screen, The first effect that you may notice is that 
the cross does not follow the lightpen, This is because the cross is 
initially locked in position and will only move to the lightpen when 
<COPY> is pressed, Try keeping <COFY? pressed and waving the lightpen 
on the screen, The cross represents where the first drawing pin Cor the 
start of a shape) will go, Let the <COPY> key go and the cross will 
lock into position, It can now be finely adjusted by using the cursor 
keys, 


When you have the cross just where you want if, press <ENTER?, The 
cross now becomes a pin, and one end of the rubber band is fixed to the 
screen, If you now press <COFY? again while maving the lightpen on the 
screen, you will see a line from the first pin to the cross at the tip 
of the lightpen, The line will not affect anything already on the 
screen, Press <ENTER> after the line is carrect, This will insert the 
second pin into place and the rubber band is held between the two pins, 
If you press <COPY> again a second Line will come from the last drawing 
pin, As you continue putting pins down, the shape grows, Up ta twenty 
pins can farm the rubber band into many complex shapes, 


For very small shapes you may not even want ta use the lightpen for 
positioning of the small cross, 


If you make a mistake in the shape you have drawn, press <DEL? to remove 
the drawing pins in the reverse order to which you placed them, 


Once your shape is finished, press <ESC> to enter the fourth menu, You 
may now wish to select a colour and a pencil to use, then select ikon 
Number twa, outline rubber band, On pressing <ENTER® the menu will 
briefly disappear, the computer will remove the rubber band, and then 
outline the path of the rubber band with the pencil and colour you have 
just chosen, 


The rubber band, although invisible, is still active, and can be reused, 
Try choosing a different pencil, then select the second ikon and outline 
the rubber band in a different pencil, You can repeat this as many 
times as you like, until you use the rubber band mode again by choosing 
ikon number one, 


Try using the rubber band to draw some shapes on the screen and see if 
you can fill them in different colours, 


eed 
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If you run out of rubber bands, then return to the menu and outline that 
section of the shape, then continue the rest of the line by entering 
ikon one again, 

NOTE: If you define a rubber band and do not use it, when you select 
the rubber band ikon again, the last rubber band will still be in use 
and you may have to press <DEL> to remove it, 


1,6 CIRCLES AND RECTANGLES 


Selbact the fifth menu:- 


Draw circle 


Draw 
rectangle 


Copy cursors 


Text Entry 


Scratch Pad 


Circles and rectangles can quickly be drawn by using the rubber band to 
specify details about these shapes as follows;- 


CIRCLE ;- 


Point on circumference 


CENTRE x~ 


a ene, 
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RECTANGLE Cor SQUARE) :- 


: a“ 
Pin|1 x2 aan 


1,6,1 CIRCLE DRAWING 


Enter rubber band mode Cikon 1, menu 4), Move the cross to where you 
want the centre of the circle to be, (By pressing <COPY> or using the 
nudge keys), Then fix that centre point by pressing <ENTER>, Now 
stretch out a rubber band to become the desired radius, (That is, the 
cross is a point on the circumference of the circle), Now fix a second 
pin using <ENTER?, then press <ESC>, 


Once the radius is defined, select the 'NEXT' ikon to enter the fifth 
manu, Now select the circle ikon on the top of the menu, The computer 
will now draw a circle around the defined radius in the current pencil 
and colour, 


Note that the computer will refuse to draw a circle if it goes off the 
screen, If the computer does refuse to draw a circle, try shortening 
the radius, or maving the centre, 


1,6,2 RECTANGLE DRAWING 


The procedure is almost the same as for the circle above, except that 
the two points defined are the ends of one of the diagonal lines through 
the rectangle, When you enter the fifth menu, select the second ikon 
(the rectangle) and press <ENTER>, The computer will now draw a 
rectangle around the diagonal you have just defined, in the current 
pencil and colour, It does not matter which direction your diagonal 
goes, a5 long as it is not a horizontal or vertical line, 


MENU REPETITION: - 
You may have noticed that the pencil and palette ikons appear on more 


than one menu, This is just to make selecting of colour and pencil 
easier, 
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1,7 COPYING, EXPANDING AND SHRINKING 


Often when you have drawn one complicated shape on the screen, you want 
to make copies of it, Copies can be easily made, or even copies which 
are bigger or smaller than the original, 


To demonstrate this facility, first clear the screen, then draw a circle 
in the centre of the screen (5e2 section 6a), Now enter menu five and 
select the third ikon, Press <ENTER? to confirm your choice, A sub- 
menu will appear containing only two ikons;— 


Copy and 
Expand 


Shrink 


The first ikon represents the copy with possible magnify, The second 
ikon is the copy with possible shrink, 


Select the first ikon, and press <ENTER>, The menu will disappear and 
your circle will be on the screen, Somewhere on the screen will be a 
set of green (lighter on monochrome) flashing corner brackets, 


Press <COPY> and move the lightpen on the screen, The brackets can be 
positioned in the same way as the rubber band cross, Use the cursor 
keys to fix the final position of the brackets, 


The brackets surround the block which you want to copy, Try to get your 
circle into the cantre of the brackets, If the circle is too big (which 
it probably will be!), then try the following:— 


1. Press down the shift key with one finger, then press the cursor 
keys, : 


2, Press down the <CTRL> key with one finger, then press the cursor 
keys, 


You should have noticed that the size of the brackets actually changed, 
and in this way try to get the cicle to fit into the brackets, 


al 
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Even after you have changed the size of the brackets, you may move them 
by pressing the cursor keys unshifted, or moving the lightpen while 
pressing <COPY?, Notice how the brackets will not go off the edge of 
the screen, 


Now that you have the area of screen you want to copy defined, you need 
to tell the computer where to copy it to, 

Press <DEL>, There are now two sets of brackets on the screen (although 
when you first press <DEL? they are on top of each other), Keep <COPY> 
pressed and move the lightpen on the screen, Notice now that the second 
cursor is blue Cor dark on monochrome) and flashing and that the first 
set of brackets is no longer flashing, Hence it is easy to tell which 
bracket is under lightpen control by which set is flashing, Pressing 
{DEL> again will swap back and forth between the two cursars, Now when 
you alter the size of brackets, you will effect the size of both 
cursors, 


Move the second set of brackets to a different position, using the 
‘nudge! feature for final setting, Now press <ENTER>, The computer 
will copy the area of screen in the first set of brackets inta the 
second seat of brackets, 


When the copy is complete (the speed of copy depends on how large the 
brackets are), the original green/light set of brackets will reappear 
and you can do another copy, Press <“ESC> to exit when you have 
finished, The green/light brackets stay in the same place at the same 
size, so for multiple copies, simply press <DEL> and move the blue/dark 
‘TO' cursor to a new position and press <ENTER>, 


Press «ESC? to return to the fifth menu as normal when you have finished 
with copying, 


1,7,1 HOW TO ENLARGE AN OBJECT 


Clear the screen and draw a very small rectangle in the bottom left of 


the screen about six pixels high by eight wide) (see section 1,6,2), 
When you are in menu five, select the third ikon (the one with two copy 
cursor Orackets), Now select the top ikon in the ne menu, ¢the one 
showing a small green/light copy cursor and an arrow pointing to a 
larger blue/dark copy cursor}, As before, move the green/light set of 
brackets so that they just surround the rectangle you have drawn, (Do 
not make the cursor tac big yet), 


Now split the brackets up by pressing <DEL> and move the blue/dark set 
of brackets to the centre of the screen, If you were to press <ENTER> 
now, you would wake a copy of your rectangle, However, before pressing 


SENTER?, press the ‘x' key, This stands for double size, The blue/dark 
set of brackets now doubles in size, Press <ENTER> now and see what 
happens , The computer should have capied the rectangle into the 


blue/dark brackets at double it original size, 
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Try repeating the above insuructions, but press '3' instead of ‘2' 
stands for treble size, Try once more using ‘4' for quadruple size, 


The keys ‘1' to '4' set the magnification factor where '}' is the same 
size as original, 


When you are defining the pasitions of the two cursors try setting 
magnification '4', then increasing the physical size of the cursors by 
pressing SHIFT and the cursor keys, As you increase the size of the 
green/light 'FROM' cursor, the size of the blue/dark ‘TO' cursor grows 
accordingly, When the blue/dark cursor gets too big it will revert to a 
lower magnification, eventually the two cursors will be the same size, 
Because of this you may need to do some copies in two or more stages, 
However if you then shrink the physical size of the green/light set of 
brackets, then the blue/dark set will attain the maximum magnification 
up to that which you have set, 


1,7,2 HOW TO REDUCE AN OBJECT 


The method used to shrink an object is similar to expanding an object 
but you need to use the second ikon on the copying sub-menu, 


NOTE: In this mode the area of screen is copied from the blue/dark set 
of brackets to the green/light set, Do not mix up the two or else you 
may lose your picture by copying a blank space onto your picture! !!! 


Draw a large rectangle in the centre of the screen using the thickest 
pencil (the fourth ikem on the pencil menu) (see section 1,6,2), Now 
enter the copying sub-menu and select the second ikon, (a large 
blue/dark cursor with an arrow pointing to a smaller green/light set) 
The menu will disappear as normal, The green/light cursor is still the 
staller of the twa cursors, Press a number ‘T' to '4' for reduction 
factor, ‘a’ is four times smaller while '1' is the same size, Now 
press <DEL» to allow you to move the blue/dark cursor around your 
rectangle, use the <SHIFT> key and the cursor keys to enlarge the size 
of the brackets, 


Use the <CTRL> key and cursor keys to reduce the size of the 
brackets Now press <DEL> again and move the green/light set of brackets 
to where you want the area of screen to go, Fress “ENTER> and the 
rectangle will be shrunk into the green/light copy cursor, 


It does not matter if the two sets of brackets overlap, however you may 
lose the original shape if the ‘'TQ' cursor covers it, 


The best way to get to know the copying system is by trial and error, 
You may wipe out a few drawings on the way but this is better than 
losing a screen you may have spent hours designing, Remember if you are 
unsure, press <ESC> and start again rather than forgetting whether you 
are in expand or shrink mode! Gnce you can use the copy cursors 
skilfully you will be surprised just how useful and ‘simple’ they 
become, 
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1,8 ENTERING TEXT 


If you want to label any of your drawings then use the text feature, 
When you are in the fifth menu, select the ABC ikon, and press <ENTER> 
to canfirm your choice, A sub-menu containing three ikons appears:- 


HORIZONTAL 
TEXT 


VERTICAL 


TEXT 


PAINT 
PALETTE 


Select a suitable colour/tone using the third ikon, then select the 
first ikon for horizontal text, After you press <ENTER> the menu will 
disappear and a single block curser (like the AMSTRAD'S BASIC one) will 
appear this represents where text will appear, Move the cursor by 
holding <COPY> down, and moving the lightpen around the screen, You can 
finely place the text by using the cursor keys to nudge the cursor one 
pixel at a time, Now type what you want to write using the keyboard, 


All the standard characters are available as normal, The text will 
appear on the screen but if you want to adjust its position, simply use 
the same method as outlined above, In this way text can be finely 


positioned and the amount of required space can be gauged, Once you are 
happy with the text, press <ENTER> and the computer will ink in the text 
permanently, If you make a mistake, press <DEL? to remove the letters 
one by one, Pressing *<ESC> will abort and any text not inked in will be 
lost, 


The same applies for vertical text, Try selecting the second ikon on 
the sub-menu, 


Interesting effects can be obtained by writing text twice, offsetting 
the second piece by one pixel vertically and horizontally using the 
cursor keys to nudge the test cursor, Try writing in two different 
colours to give the text a feeling of depth, 


To remove text that has been permanently inked in, re-write the same 
fest in the background colour, 
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You may wish to use characters from the Amstrad character set which are 
not available from the keyboard, For example characters 160 and 161 are 
useful for french text, To enter these characters you need to look up 
the character's code in your Amstrad manual, When you require a special 
character, while entering normal text press <TAB> and then enter the 
character's code using THREE numerical digits, For example the 
character number 168 is entered as:- 


{TABS 16 9 


You do not need ta press “ENTER? for the character to appear, Pressing 
<DEL? will delete the character as normal, NOTE: even if the code of 
the character is one of twa digits, you still need to type out THREE 
digits, using preceding zeros if necessary, For example the character 
number 4 is entered as:- 


<TABY @ @ 4 


If you make a mistake in entering the digits, then press space and start 
again by pressing <TAB>, 


1,9 FINE DETAIL AND ALTERATIONS 


When you are trying to draw vary fine detail on the screen, where every 
pixel may be in a different colour, it would be nice if a section of 
screen could be magnified to a suitable size, 


For this reason a ‘scratch pad’ has been used to allow very fine detail 
to be applied to the whole screen, 


Craw a small circle on the screen Cone with a radius of about & pixels), 


(See section 1,6,1) Now select the last ikon in the fifth menu (the one 
that looks like a pad), Another sub-menu will appear as follows;— 


SCREEN TO 
SCRATCH PAD 


EDIT 


SCRATCH PAD 


SCRATCH PAD 
TO SCREEN 


AMSTRAD GRAPHICS LIGHT PEN 19 


OK‘ tronics manufacturers of powerfull peripherals 


Use the top ikon and press <ENTER?>, (This represents a screen to pad>. 
The menu will disappear and a red or dark bracket cursor will appear 
Similar to the copy cursor mode (see section 1,7), These brackets can 


be moved using the <COPY> key and the lightpen, or by using the cursor 
keys to nudge the brackets to a single pixel, Notice that this set of 
brackets 15 a single size only, Move the brackets so that they surround 
the circle, (If your circle is too big, then you may needa to redraw 
itd, When you have the circle in the centre, press <ENTER?, the 
section of screen is now ‘blown’ up to a size where fine detail can 
easily be done, 


At the very bottom of the screen is a band containing the ink colour, 
Press the keys ‘*1' through toa ‘@' on your keyboard to select a colour 
within the scratch-pad ONLY. If you press the key labelled <CLR> then a 
special transparent colour will be used (sown as vertical bars), This 
colour will not be copied from the pad and hence will let the original 


colours on the screen shaw through, Now paint the lightpen at the 
screen by pressing ‘ENTER*, you will be able to plot pixels in the 
current colour, Use white to blank out any mistakes, 


Perhaps easier to use than the lightpen in this mode are the cursar 
keys, Use these to move the flashing cursor around, Once they are 
pressed they lack out the lightpen until <COPY> i5 pressed, 


Using the lightpen or the cursor keys, alter the circle, Now press 
<ESC> and the sub-menu will reappear, Now select the third ikon (this 
rapresents pad to the screen) and press “ENTER? to confirm your choice, 
The red brackets reappear and pressing “ENTER? copies the contents of 
the scratch-pad to the area of screen inside the brackets, If you don't 
move the brackets, then your circle will be ‘updated', If you move the 
brackets by holding down <COPY> and using the lightpen or by nudging the 
brackets, then multiple copies of the circle can be created, 


Now press “ESC? and select the second iken on the sub-menu, This 
returns you to the scratch-pad, You could now re-edit the circle, or 
even start again, 


If you want to create your own high-reselution object then clear the 
whole pad to a background colour; Select any colour using the ‘1' to 
'9' keys Ca good idea would be to use white, key '1'), then press <CTRL? 
and <TAB? together, The screen will blank to the selected colour, Now 
select another colour and use the lightpen or cursor keys to draw a 
graphic object, Once you have finished press <ESC> and select the third 
ikon to place the contents of the scratch-pad onto the screen. Fress 
<ENTER? and move the brackets around, Fress <ENTER? again to place the 
object anywhere on the screen, 


ooo 
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ee 


You may already have a complicated background onto which you want to 
place an object without the background being removed around the object, 
lf this is the case then simply design your high-resolution object on a 
transparent background (selected by pressing <CLR>), If you have picked 
up an object from the screen with a set background then whilst in edit 
mode change this background to transparent <CLR) or select the same 
colour as the background and press <SHIFT> and 'x', This is to save you 
the trouble of manually changing all the background to clear, 


The use of the scratch-pad, although seeminly complicated helps to make 
alterations to parts of the screen very quickly and accurately, 
Practice using the pick-up, edit and put-down sequence to edit your 
pictures, Also be careful not to forget you are in put-down mode when 
you try to pick something up, the result is the writing over of what you 
originally wanted to edit (and much displeasure to say the least!), 


1,18 USING TAPE ANO DISC DRIVES 


The graphics package supports both tape and Amstrad disc drives, If you 
have no disc drive connected then the software acknowledges the fact and 
does not allow you to try and use discs, 


There are two sections about tape and disc which will be of interest, 
and those are (1) saving the Graphics Package itself ¢including putting 
the software onto disc from the tape) and (2) saving pictures you 
create, 


The first one is considered next, 


1,171 BACKING-UP YOUR GRAPHICS PACKAGE ‘cassette version) 

The software is NOT protected because users with disc drives may want to 
transfer the software to their discs, Secondly the software is saved 
using SPEED WRITE 6; users may wish to resave a copy in SPEED WRITE 1, 


Finally keeping a back-up is always recommended, and saves the trouble 
of ordering a second copy when you leave the tape on a magnet! 


71,171,171 TO LOAD WITHOUT RUANING: — ‘cassette version) 


In all cases, the Graphics Package needs to be loaded into the computer 
as oultined below, 


1, If your disc is attached then type ‘iTape' and press <ENTER>. 


2, Type 'LOAD “LPEN"' and press <ENTER>. 


a 


Put the tape in the tape driva and rewind the tape. Fress <PLAY> 
then press any key, Oo not release the <PLAY> key unless a TAPE 
ERROR occurs, in wich case refer to the Amstrad manual for 
loading tints. 
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4, When the computer has finished type ‘35 STOP’ and press <ENTER>, 
5, Now type 'RUN' and press <ENTER?, 


&, The tape will start to run again and about four minutes should 
pass, 


7, Finally type '35' and press <ENTER?, 


The complete program is now in the computer, 


1,11,2 TQ SAVE TO TAPE: - (cassette version) 
1, Select the speed of tape you want to use:- 


Type 'SFEED WRITE @' for slow, safe SAVE, 
Type 'SPEED WRITE 1' for fast SAVE, 


bh 


Place a blank cassette into the drive, Tt needs ta have at least 
five minutes of tape on it Cor left on it), 


ae 


Typeim 


SAVE "LFEN"; SAVE "GRAPH", B, 6000, 7600: SAVE, 
“PROG", B, 32766, 9750 and press <ENTER>, 


4, Press ¢PLAY> and “RECORD? then any key, You will need to press any 
key twice again for each section, 

1,11,3 70 SAVE TO DISC;-(cassette version) 

1, Type 'IDISC' and press <ENTER?, 


2, Fut a disc in your drive which has at least 19K free an it, Make 
sure the write protect tab is off, 


Typeso 


SAVE 


SAVE "LPEN" 
“PROG", £, 


SAVE "GRAPH", B, 6000, 76 
22765, 9758 and press <ENTE 


NOTE: You way wish to use SPEED WRITE 1 when saving pictures (see 
section 1,12), If so, before saving a copy of the program onto tape or 
disc, add this line;- 


SPEED WRITE 1 


Now save the pragram as outlined above, 
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1,12 LOADING AND SAVING 


Once you have completed a picture, if can be stored on tape or disc for 
later use (see section 1,14), The very first menu contains the ikons 
which contral saving and loading, Fress < as many times as needed 
to peturn to the first menu, Whether you have a dise drive or not, the 
first two ikons represent tape to computer (Load), and computer ta tape 
(Save), If you have a disc drive attached then you have the option of 
using tape or disc and there are two more ikons representing disc to 
computer (Load), and the computer to disc (Save), 


To save your picture select the second ikon (tape) or the fourth ikon 
(disc only}, The computer will ask you for a name, to be typed fram the 
keyboard, Only letters and numbers are allowed, If you use disc then a 
directory containing any other pictures and amount of free memory will 
be displayed, CIf you wanted directory only, press @ > ta abort at 
this stage, ? Once you type in the name, the camputer will save the 
whole picture, For tape this will take some time, and the computer will 
inform you haw many blocks if has saved, On disc, the computer will 
return ta the main menu after a short time, unless an error occurs, If 
a disc error does occur then a message will be displayed, you may either 
correct it for non-fatal errors eg, read errors etc, or press any key 
and the first menu will reappear then you may need to change the disc 
and re-save ta picture, 


It is wise ta save complicated pictures frequently (especially if you 
have a disc? in case you make a mistake, (Like filling the screen in 
white!) It takes only two minutes to save a screen using SPEED WRITE } 
(see section 1,11} or three and one half minutes using SPEED WRITE 9, 


On the disc drive, pictures may be saved with the same name and the 
computer will rename the old version using the BAK extensian, Consult 
your manual if you are unfamiliar with the AMSTRAD Disc Operating 
system, 


Ta Load the picture from tape select ikon one, or ikon three if you are 
using disc, If you are using tape then the computer will load the 
first binary file on the cassette onto the screem, This need not have 
been one saved by this package, If all goes well, sight blocks will 
load into the computer, The computer will report on its progress as 
normal, Any errors will be reported and the action you need to take 
depends upon the error eg, if the disc read error occurs then the 
message "try Retry or Cancel" is displayed. 


Note that the files which are output are standard binary files and can 


be used in your own BASIC or machine code programs, (See section 1,11 
and 1,12.) 
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1,13 USING PRINTERS 


To obtain a hard capy of your pictures (or any others you may have 
created without this package), it is necessary to load the second 
program on the tape supplied with your Graphics Lightpen, This program 
does not support any specific printer but it converts the colour data on 
the screen into a farm which printers accept their data, This data can 
then be very quickly output from a BASIC program designed to suit YOUR 
printer, Two example BASIC programs are included for EPSON and AMSTREAD 
printers, Fram these and your own printer manual it is hoped that any 
printer, which can be controlled normally from your computer, can be 
used to produce a screen copy, 


Also those users with expansion parallel printer parts, many of which 
use eight bits instead of seven, can very easily use these ports instead 
of the Amstrad one, This is possible because all the printer handling 
is actually done from BASIC, 


1,173,171 EPSON PRINTER EXAMPLE; -— 


Before you can make any copies you need to have saved your picture on 
tape or disc, Now reset the computer and follow these instructions; — 


1, Connect up your printer and make sure that it is working 
carrectly,also conrect the disc drive if you are going to be using 
discs, 


2, Switch on and type ‘MEMORY 9999' and press <ENTER>, 


3, Load the second program on the software cassette, It is found at 
the end of either side, Fast forward the cassette until you are 
nearly at the end of the cassette and type ‘LOAD "DUMPMC"' and press 
<ENTER?, If the program fails to load then rewind the tape and try 
again, 


4, Type in the following program making sure you copy it exactly:— 


® MEMORY 33999;MODE 9% 
S=S;POKE 40603,5:;POKE 40004 ,6 
INPUT "NAME OF SCREEN"; Y$;:LOAD Y$ 
@ CALL 49000;REM REMEMBER TO LOAD DUMPMC FIRST! (STAGE 33 
WIDTH 255;FRINT #3, CHRSC27); "A" ;CHRS(4); 
B=: IF THEN D=Se 
e202 0F S>2 THEN L=L-6 
9 C=100@8;FOR J=1 TO D:LA=C:FOR T=) TOL 
PRINT #5, CHROC 2735 SKC ( ,;CHRE$(@).;FOR K=1 TO 86 
O@ PRINT #5 REC PEER CCO/169; :CHC+1 NEXT k,1 
® PRINT #38:C=LA 
2 FOR l=) TO L!PRINT #8,CHRS(27); "EK"; CHRSCE@? | CHRESCO); 
30 FOR K=) TO S@;PRINT #8,CHRSCPEEKCC) AND 15); 
a CaC+); NEXT KT: PRINT #6:NEXT J 
4” END 


fn ened 
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en 


an 


Type 'RUN' and press <ENTER?, 


feat 


In reply to the prompt ‘NAME OF SCREEN' type the name under which 
you saved the screen, or just press “ENTER? if you are using tape, 


7, The sereen will load and after a pause the printer will print out 
your screan using a shading effect to show the different colours, 


6, (¢You may wish to SAVE the above program yourself to save retyping 
it avery time you need to use it?, 


7,1713,2 AMSTRAD PRINTER EXAMPLE; ~ 


The procedure is almost the same as for the EPSON printer except that 
the program for step 4 is as follows:- 


19 MEMORY 9999:MODE 6 

30 S=5:/POKE 40003,5;POKE 40004, 1 

30 INPUT"NAME OF SCREEN"; Y$LOAD Y$ 

40 CALL 40000 

5 WIDTH 255 

60 DIM 0C#,5):FOR I=) TO 8:FOR J=1 TO 5; READ DCI,J): NEXT J, 

7@ DATA 127,1,9,1,) ,128,128,63,2,8 ,192,64,31,4,0 

BO DATA 224,32,15,8,0 ,240,16,7,16,0 ,248,8,3,32,0 

99 DATA 252,4,1,64,0 ,254,2,9,1,@ 

190 C=10000;S=1;L=1 

11@ FOR I=] TO 6:PRINT #8, CHRS(27):"K";CHR$CO);CHRSCE) 

128 FOR J=1 TO S@;PRINT #8,CHRS((PEEK(C) AND 0 
(S,19)/DCS, 294+ (PEEK(C+48@) 
AND DCS, 3) )#dCS,4));;C=C+1 NEXT J, 1 

130 PRINT #8:C=C-480eD(S,5);S=S+1;IF S=9 THEN $=] 

149 L=L+1:1F L=58 THEN STOP 

15@ GOTO 116 


1, 13,3 ADVANCED INSTRUCTIONS FOR PRINTOUTS 


While the BASIC program in the two above examples looks complicated, 
most of the hard work of converting the screen into data has already 
been done by the machine-code program you first loaded, The BASIC 
program simply outputs the data to the printer after sending the 
respective printer's control codes, If you have one of the above 
printers then you need not worry about the next section, however you may 
have a different printer or simply be interested so let's go through the 
EPSON printer program step by step to see what is happening:- 


After setting MODE 0, the program sets two variables in the machine-code 
program, The variable $ sets the size of printout, Location 40003 is 
the altered to that value to inform the machine code of the size you 
want, 


EEE 
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On the EPSON there are a possible 486 (in single density mode) pixels 
across the paper, This means that is the capable of displaying the 
largest size of output possible from the machine code program, On other 
printers however there may be less pixels across and hence a smaller 
size may need to be used, Try different values of 5 (8 to 5S) on your 
EPSON printer to illustrate the effect, 


The screen has dimensions of 160 pixels across the screen and 200 pixels 
down the screen, The machine code software can convert these to six 
differant sizes on the printer, The possible dimensions are:- 


@ 160 pixels across and 200 pixels down 
1 320 pixels across and 200 pixels down 
2 486 pixels across and 200 pixels down 
3.168 pixels across and 460 pixels down 
4 326 p across and 40@ pixels down 
§ 426 pixels across and 406 pixels down 


wm iw wn 
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For your printer you will need to look up in your printer manual how 
many pixels your printer is capable of printing in one row, Then select 
a value of S that is smaller or equal to that maximum value, 


As any printer prints, the head will print a number of dots in a 
VERTICAL column, so this is how the data from the screen is converted, 
Starting from location 10600 in memory, data is created where each byte 
represents one vertical column, The printer then fas to be informed 
that the data is on its way, and the BASIC program needs to simply send 
the data from memory to the printer, 


The location 40004 needs to contain either a @ or at, ‘'®' specifies 
that the most significant bit of the data is the bottom dot while ‘1° 
means that the most significant bit of the data is the top bit, If you 
are unsure, use ® and it will be clear whether you need to use a 1 
because the printout will be upside down! 


Line 20 loads the screen from tape or disc, Note that the MODE 6 
command makes sure that the screen has not scrolled, That, is the 
screen always starts at 49152 in memory, 


Line 46 calls the machine code routine and fills the memory of the 
Amstrad from 10006 onwards, the actual amount of data depends on the 
size value S$, For 3=5, 24K of memory is needed, 


Line 58 commands the EPSON to move just 4 pixels between every line, 
You may need to consult your printer manual to find out how to set the 
distance between rows, In some cases it may not be possible to set a 4 
Pixel line setting, In this case you may have to set a 7 pixel line 
setting and output 7 pixels of data at a time, meaning that the battom 
row of pixels in each line will be lost, 


It i8 necessary to note that the Amstrad's CENTRONICS parallel port uses 
only 7 bits, While this is industry standard, the EPSON and many other 
printers use & bits, 
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With only 7 bits you may realise that is impossible ta send 8 pixels of 
data in one instruction to the printer, Hence on the EPSON Cand more 
than likely on your printer) it is necessary to send the top four bits 
and then the bottom four bits seperately, 


In line 68 a variable D is calculated, O stands for depth and is either 
25 lines or 5@ lines depending on which size (5) of prinout was selected 
in line 28, On the next line L is calculated, Lois the number of 
blocks of 80 bytes of data, Hence if you use the largest size of 
printout (480 pixels) then value of L ois 6, The data is output as 
blocks of 80 bytes and not as a block of 480 bytes for one reason, When 
the amount of data to be printed is sent to the EPSON, then EPSON 
requires a low and high byte value, 


If 486 were converted to low and high byte values you would get 224 low 
and 1] high, ie (1#256 + 224 = 456), 


e to the 7 bit CENTRONICS port, it is impossible to send the value 
224, Hence it is safer to send blocks of 30, 


After all these variables have bean created, the program sets C to 18000 
to count through the memory from 10000 onwards, 


There is a loop (J) going through each row up to 28 Cor 56 if double 
height is used), Then there is a second logp ¢1)? going through each 
block of 50 bytes, 


Finally the printer is told that if is to print out 50 bytes of high- 
resolution data 'CHR&CZ7);"K") CHRECEO) ;CHRECO))', You will need to 
supply this from your own printer manual, 


NOTE: Some printers use bit 7 being a |} to designate high-resolution 
data, If this is the case with your printer, then your printer will not 
produce high-resolution with the AMSTRAD at all. 


80 bytes are now read from memory and set out to the printer, Note how 
the top 4 bits are selected by dividing by 16, Finally a carriage 
return and linefeed is sent, 


Line 120 onwards repeats the same data but this time the bottom 4 bits 
are sent by masking out the high 4 bits, (Do net worry if you are 
unfamiliar with '/16 and ‘AND 1S5', just believe they seperate the top 
and bottom 4 bits!) 


Sa that's all there is to it!!! If you are confused, try reading your 
printer manual thoroughly, especially the sections on high-resolution 
printing, Try using some of the examples in the manual and change the 
EPSON program to ftontain sections relevant to your printer, Also 
instead of keep loading a screen from tape or disc, delete line 2@ and 
replace it with this line:- 


36 FOR 1=1 TO 1@; FOR J=1 TO 15:PEN J: PRINT CHRS(644.1);: 
NEXT J;PRINT: NEXT I 
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This will print some different coloured letters on the screen as a test 
screen, 


The authors sincerely hope that presenting the printer routines in this 
form will allow greater flexibility to use any printer which supports 
high-resolution graphics, 


We hope that it can be appreciated that there are hundreds of different 
Printers which can be used with your Amstrad and a single printer 
routine could never support all of them, The ateve information should 
make it possible to support your printer, with as little effort on your 
part as possible, 


1,14 USING SCREENS IN YOUR OWN PROGRAMS 


The screens which are saved from the Graphics Fackage as standard binary 
files, 


These can be loaded inta your programs simply by using a line such as:- 


40 MODE @ 
5@ LOAD "NAME" 


Where the 'NAME' is what you called the screen when you saved it, 
The colours used in the Graphics Package are not the same as the colours 
assigned when the computer is first switched on, Hence you need ta re- 


define the INKS bafore you see the pictures in the correct colours:- 


16 BORDER O;RESTORE 20;FOR I=6 TO 15;READ A:INK 1,A;NEXT I 
29 DATA 26,15,9,17,5,11,13,22,0,24,6,2,14,19,2,3 


If you like you can load the screen into other areas of memory by adding 
a load address on the end of the above statement: — 


30 MEMORY 19939 
49 LOAD "NAME" , 20000 


This will load in a screen at 26000 in memory, If you are doing this, 
remember that your BASIC program has less memory than normal, 


You could even write a short machine code program to move the picture to 
the screen when you need it like the one below: 


60 MEMORY 19900:RESTORE 70:FOR I=1995@ TO 19961:READ A: 
POKE 1,A:NEXT I 

78 DATA 78,1,0,64,17,0, 192,237,176, 201 

38 CALL 13959 


NE 
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a 
This will move the screen which has been loaded at 20000 onto the 
screen, You may even like to blank all the inks before you make the 
transfer to make the picture appear immediately, 

6 FOR 1=@ TO 1S: INK 1,9;NEXT 

Then switch INKs back on again;~ 

146 RESTORE 28:FOR I1=@ TO 15:READ A; INK 1,A:NEXT I 

If you own a disc drive then you could write a program Similar to the 


one below which presents a number of pictures on screen almost like a 
slide show, 


39 PRINT" 
43 FRINT" 
59 PRINT" 
£0 $=5:REM NUMBER OF SCREENS TO BE DISFLAYEO 
70 DIM NSCS) 
SG N¢C1)="HOUSE"VREM NAMES OF SCREENS ON DISC 
39 N$(2)="SHIP" 
106 N$CZ)="SPEECH" 
110 N$C4)="CHART" 
120 NSC5)="CAR" 
130 PEN 2 
140 PRINT: PRINT:PRINT:PRINT "DELAY BETWEEN SCREENS (10 - 6000 
SECS)": PRINT;PEN 3; INPUT “ 
156 IF D¢<>INTCD) OR D<1@ OR 036900 THEN 140 
168 D=D-5 
17@ MODE @:RESTORE 176;FOR I=6 TO 15;READ A; INK 1,A;NEXT I; 
DATA 26,18,9,17,8,11,13,22,4,24,6,2,14,19,2,3 
180 NS<O:FT=1 
19@ LOCATE 1,13;FRINT " SCREENS FOLLOW!" 
200 FOR I=1 TO $ 
SL=16384:1F NS=1 THEN SL=4915z 
TSTIME:LOAD N€CL) ,SL;IF FT=1 
8 WHILECTIME-T)/300<D ; WEND 
POKE 16351,192:1F NS=@ THEN POKE 16351 ,64 
4 CALL 16350:REM SWAP SCREEN BEING DISFLAYED 
NS=NS+1; IF NS=2 THEN NS=o 
NEXT 1:GOTO 200 


THEN FT=9;GOTO 240 
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1,15 USING THE GRAPHICS LIGHTPEN IN YOUR OWN PROGRAM 


Your program could be as complicated as this Graphics Package or as 
simple as a telephone directly program, but both are improved by using a 
lightpen to save using the keyboard for choices, 


Listed below are two programs, one in BASIC and one in machine code to 
allow you to raad the position of the Lightpen on the screen, 

IN BASIC:- 
18e08 OUT &1Ce8 


18010 L=H 
19026 RETURN 


A GOSUB 16606, would return X and Y coordinates of the position of the 
lightpen, X ranges from @ to 39 and Y ranges from @ to 24, This scale 
is irrespective of which mode you use, although when in MODE 1, each 
graduation represents one character square, 


(The value 12292 may have to be altered by one or two to suit your 
moniter or television, } 


IN MACHINE CODE: - 


COORDINATES: LO BC,1ICOOH ; set register pair to 1C60 
LD A,17 
OUT (C38 
LD BC, TFaOH 
IN L,¢C) ; read tow order position 
LO BC, 1C®BH 
LD A,16 
OUT (C3,A 
LO BC, 1F@GH 
IN H,¢C3 ; Tead high order position 
LD DE,1 ra 
AND A 
SBC HL ,DE ) Yenove constant offset. 
LD BC, ® 
LD DE, 40 


divide by 40 
LOOP: 


We 


is Y position 


LB EBL ; B is remainder =X 


>< 


This routine 


where BX : 


and Y cocrdinates in the BC register pair, 
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The two routines above could simply be included in a program which uses 
menus or need to select choices from anywhere on the screen. 


EXAMPLE: - 


The program below is a simple reflex tester, Type it in carefully then 
RUN 1b, 


After the title disappears, four boxes will be drawn, The word HERE 
will appear in one of the boxes and you need to point the Lightpen ta 
that word as quickly as you can, Ten times the computer will select a 
box at random, The total time will then be given, the lower the score, 
the bettr you have done, Our lowest was 2,85 seconds! 


Try changing parts of it, if you want, or experiment with writing 
programs of your own, 


INE 3,20 


10 MODE 1:BORDER @:INK @,26;INK 1,@:INK 2,12; 
26 PRINT , ," TEST YOUR REFLEXES" 

20 FOR [=] TO 2000;NEXT:CLS 
40 C=l;FOR i=] TO 25 STEP 339+) :FOR X=24 TO 344 
STEP S20:FOR Y=16 TO 216 MOVE X+1, Y+1 ; DRAW 

X+1+250, V4, C:DRAW X+1+250, Y+1+150,C:DRAW X41, YFI+150,C; 
DRAW X+1,Y+1,C:NEXT Y,X,1 
6@ PEN 1:V=5:FOR N=) TO 16;REM NUMBER OF TESTS 
60 VISINTCRNDEA) IF VeV1 THEN 6 
7@ FOR I=) TO INTCRND*300094+1500;NEXT I 
GO VEVIIX1ES+¢V AND 19¥Z0:Y147+(V AND Z#6;LOCATE X1, YT; 
PRINT "HERE!" 
90 T=TIME 
106 LOCATE 18,123:;PRINT INTCTIME-T)/3)/100;"  ";GOSUB 10000; IF 
CY-1<Y] AND YESSY) AND CX-S<XT AND X+1>X1) THEN 120 
114 GOTO 108 
126 LOCATE X1,Y1:PRINT" "OREM 5 SPACES 
130 TT=TT+CTIME-T) :NEXT N 
148 LOCATES, 13;PRINT'YOUR TIME WAS"; INTCTT/3)/100; "SECONDS, " 
150 for I=] TO 3000;NEXT:LOCATE 1,13; 
PRINT" "OREM 5 SPACES 
166 RUN 5é 
10900 QUT &1C80,17:L 
19018 29 
16620 RETURN 


=INPCRI FOO) :GUTRICO8, 16;H=INFCRIF OO) 
Bi Y=L/40;X=L-Y*40 
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1,16 REVIEW OF GRAPHICS PACKAGE COMMANDS 


This section is intended as a quick reference once you have gone through 
the rest af the manual, Use it in conjunction with pages 34 and 35 
showing all the menus and the menu numbers, 


Menu 1; Ikon 
Ikon 
Ikan 
Ton 
Ikon 


Menu 2; [kon 
Ikan 
Tkon 


Menu 3; Ikon 
Ikon 


Ikon 
Ikon 
Ikon 


Menu 4: Ikon 


Than 
Tkon 
Tkon 
Ikon 


ine i po 


wh 


ine oo he 


Load Screen from Tape {Section 
Save Screen to Tape (Section 
Load Screen from Disc (Section 
Save Screen to Oisc (Section 


Gota Menu 2 


(Ikons 3 and 4 will be missing on tape only systems) 


Clear Screen to White Background (Section 
Calibrate Lightpen (Section 
Goto Menu 3 


Draw Mode (Section 
(Use <ENTER> and SPACE BAR) 
Fill Mode (Section 
(Use <ENTER? to fill area) 
Select Ink Colour/Tone (Section 
Select Pencil Taxturs and Size (Section 


Goto Menu 4 


Rubber Bands (Section 1,5 & 
(Use “ENTER? for pins <COPYs to move rubber 
bands out, ‘ESC> to finish) 


Outline Rubber bands (Section 
Select Ink Colour/Tone (Section 
Select Pencil Texture and Size (Section 


Gota Manu 5 


ad 
1 


ra 


2 


3 to 


woo 


be ho 


2 


2 


a io 


xx) 


wee 
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Menu 5S: [kon j Draw Circles (Section 1,6,1) 
Use first pin for centre, second pin to 
set radius) 


Ikon 2 Draw Rectangles (Section 1,6,2) 
(Use 2 pins to set diagonal? 
Ikon 3 Copy, Shrink and Expand (Section 1.7) 
Sub Menu: Ikon 1 Expand or Copy (Section 1,7,1) 
(Set magnification '1' to ‘4° then copy 
from green/light to blue dark cursor) 
Ikon 2 Shrink (Section 1,7,2) 
(Set reduction factor ‘1' to '4' then 
copy from blue/dark to green/light 
cursor } 
Ikon 4 Entering Text (Section 1,8 3 
(Select horizontal or vertical text 
from sub menu, Set colour if you want} 
kon § Scratch Pad (Section 1,9 >) 
Sub Menu; Ikon 1 Screen to Scratch Pad (Section 1,9 ) 
(Move the cursor then copy area of 
screen to scratch pad by pressing 
<ENTER? 3 
Ikon 2 Edit Scratch Pad (Section 13 ) 


(Select a colour using keys ‘1' to '@', 

then use <ENTER? to plot pixels? 

Ikon 3 Scratch Pad to Screen (Section 1,9 ) 
(Press <ENTER> to copy scratch pad to 


area of screen outlined by cursor) 
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1,17 MENU SCHEMATIC 


GRAPHICS LIGHTPEN 


MENU 1 MENU 2 MENU 3 ME 


et ee" a 
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COPY MENU 


COPY & 
EXPAND 


SHRINK 


Circle 


4 
»] BANDS” 


TEXT MENU 


. OUTLINE VERTICAL 

: TEXT 

2 g HORIZONTAL 

° SET 

COLOUR 

SET 

ge COLOUR 
SCREEN 
TO PAD 
E0IT 
PAD TO 
SCREEN 


a 
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SPEECH SYNTHESIZER 


The DE'tronics speech synthesizer uses the popular SPOZ56 speech chip, which 
gives it an almost infinite vocabulary, It is supplied with a text to speech 
convertor for ease of speech cutput creation, Every thing you wish to be 
spoken is entered in normal English without having to use special control 
codes or characters, It is therefore extremely easy to use, The voicing of 
the words is completely user transparent and the computer can carry on with 
its normal running of a program while the speech chip is talking, The speech 
output from the SPOZS56 is mono and directed to both speakers via a powerfull 
stereo amplifier, 


STEREQ QUTPUT 


To utilise the Amstrad stereo output on the back of the computer the 
interface has its own built in stereo amplifier which is cannected to two 
high quality 4" speakers, This gives all sound output a totally new 
dimension and greatly improves the sound quality and volume over the 
computer's internal speaker, All programs that use sound in any way will now 
be output through the interface, The interface is also supplied with volume 
and balance controls, 


SPEECH SYNTHESIS 


The speech synthesis utilises parts of the spoken word known as allophones, 
These are actual sounds that go to make up speech, The SPO256 allophone 
speech synthesis technique provides the ability to synthesize an almast 
unlimited vocabulary, Fifty-nine discrete speech sounds Callophones) and 
five pauses are stored in the speech chip's internal ROM, 


TEXT TO SPEECH 


Although there are only 26 letters in the alphabet, latters have a totally 
different sound when used in different words, For example, the "a" in "hay" 
is much longer and softer than in “hat", When you speak you automatically 
make adjustments because you know just how the word should sound, This is 
not quite so easy with a computer, 

The machine code software supplied is mainly developed to this mode of 
operation, of which 3,5k is used for tables which contain the rules and 
exceptions to the English Language, For example I before £ except after C, 
This therefore allows the user to enter words to be spoken in normal 
English, 


NEW BASIC COMMANDS 


There are 19 new Basic commands which control all the functions of the 
interface, making the synthesizer very easy to use, i¢ to say “Amstrad” you 
would enter: 10 PRINT “'Amstrad’", You can even control the speed at which 
it talks, or use thr synthesizer to create sound effects on a fourth sound 
channel , 
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WARNING 


This unit sust be used in accordance with these instructions, Never plug in 
or remove the interface without first disconnecting the power from the 
computer, Failure to follow these instructions may result in damage to the 
interface or the computer, 


2,1 INSTALLATION 


The jack plug on the short flying lead must be cannected to the stereo 
output on the rear of the computer next to the joystick socket, The speech 
interface can only be connected to the floppy disc port, The speakers are 
plugged into the left and right sockets on the interface, the left socket is 
the left channel, the right socket is the right channel (as viewed from the 
front of the interface), The computer can now be switched on, 


2,2 SETTING UP AND USING THE STEREO AMPLIFIER 


The volume control is located the right hand side of the interface for the 
CEC 464 and on the left hand side of the interface far the CPC 6128, To 
check the volume setting type in the following line of program as a direct 
command, 


SOUND 2,50,2606 (Enter), 

You can new adjust the volume to the required level, 

Just below the volume control is a small hole, this is the balance between 
the left and the right channels and is factory set and should not require 
adjustment, 

To check the balance type in the following program, 

1@ SOUND 1,58,100:;REM Left channel. 

20 SOUND 4,54,10@;REM Right channel. 

36 GOTO 16 

RUN <ENTER> , 

You should hear the tone change between the left and right speakers, If it 
is necessary to adjust the balance you should use a small screwdriver, The 
internal speaker on the Amstrad should be turned down (right-hand end for 


the 464, rear right for the 6125 computer) as the mono output could distract 
from the affects of the stereo output, 


eg SS Se 
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Any sound that previously came out of the mono internal speaker will now be 
sent out via the interface in stereo, 411 programs that use the sound in 
any way (ie commercial software) will now output through the interface, 


2,3 SPEECH SYNTHESIS 


The Amstrad speech synthesis utilises parts of the spoken word known as 
allophones, These are actual sounds that go to make up speech, The SPO256 
allophone speech synthesis technique provides the ability to synthesize an 
unlimited vocabulary, Fifty-nine discrete speech sounds Callophones) and 
five pauses are stored in the speech chips internal rom, In the past, 
Speech Synthesis has required large data bases to store words because every 
word had to have its own set of data, This method of synthesis speech is 
slightly clearer than the SFO256 speech chip but would require at least 5 
mega bytes of memory to store the English Language, This is obviously not 
practical, Therefore, for the home computer the SPO256 is the ideal chip, 


2,4,1 SOFTWARE LOADING DETAILS (cassette) 


The software cassette supplied with your Amstrad Speech Synthesizer has been 
recorded in speed write @ and speed write 1, To load press the green 
contral key and enter (the numeric key pad enter), Note that if you are 
using the CPC 664 then you will require an external cassette player 


The software is in two parts the first part is the relocater, this enables 
you to load and run the software in the 16364 to 39000 part of the basic 
memory map, This is because other software may be running in high memory 
(ie disc software), The second part is the machine code to run the text to 
speech converter, this is 4K in length, 


After the first part has loaded the screen will clear and ask you for the 
load address, This should be a high address in the range of 16384 to 39000 
(39000 is a good address), The routines will automatically lower HIMEM so 
that basic will not run into the machine code it is important to remember 
the load address if you intend using speech from machine code, 


Once the second part has loaded the machine code will perform the 

initialisation routine and print the capyright message on the screen, 

2,4,2 SOFTWARE LOADING DETAILS (ROM) 

On power-up the Rom showld identify itself with the sign-on message :- 
SPEECH ROM VER, 1,1 


All that is required to initialise the Speech Rom is to type in 'Ispeak' 
then press <ENTER?, 


This will alsa test the unit by saying “OK' tronics speech synthesizer" and 
displaying the extra commands, 


Sea eee a rE 
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2,5 BASIC COMMAND EXTENSIONS 


There are 10 new basic commands and an example of their use is given below, 


tSPON Turn on the interrupt to read the buffer, (speach on} 
{SPOF Turn off the interrupt and stopreading the buffer, (speech off) 
FEED ,n 


This is used to feed the speech buffer direct and also for 
sound effects, The !FEED,n command is followed by a maxinum 
of 30 data items seperated by commas, 

IFLUS This command clears the speech and text buffers, 


tSPED,n This command contrals the speed at which the words are spoken, 
n, is a number from @ to V5, 


{OUTM 1 Sets access to ‘text to speech' using print "'xxx'" only, 
ie listing etc will not be spoken, 
LOUTM, & Sets access to ‘text to speech’ from all print outputs , 


Anything that outputs to the screen ie listings, Syntax 
errors, ready will be spoken, (BUT WITHOUT PRINTING THEM ON 
SCREEN), 
tQUTM, 2 As JQUTM,2 but text is spoken and printed on the screen, 
NOTE: !OUTM,2 and |QUTM,3 can only be stopped by the break key, 
Note during extensive printing in {QUTM Zar 3, the computer may seem to be 
unresponsive ta the Break kay, This is due to the speech buffer being full 
and Basic waiting until there is some more space, 
To break out this keep the break key pressed until Basic scans for it, then 


the computer will print BREAK fallowed by READY while continuing to stay the 
contents of the buffer which may continue for up to a minute, 


The two remaining commands are only available on the Ram version, They are;— 
tLEFT, Returns the value of the free memory in the speech buffer, 
This is used as follows j- 
1960 ax=% 
181G bleft, @ar 
1629 print a% 


With the buffers empty the result would be 25¢ bytes, 


a 
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ISAY, This command is the normal way of getting the unit to speak, 
It uses the text to speech convertors, The correct syntax for 
othe command is:- 


mm 


64, 6128 computers: fsay, "the cat sat on the mat” 


464 computers; af="the cat sat on the mat": Isay, @ags 


2,6 SPEECH SYNTHESIZER 
The speech synthesizer can be used in various modes, 


a) DIRECT- WITHOUT SOFTWARE SUPPLIED, 
b) USING |FEED COMMAND, 

c) USING THE TEXT TO SFEECH CONVERTER, 
a) USING PRINTING MODE COMMANDS, 


2,6,1 SPEECH CONTROL DIRECT FROM BASIC 


The speech chip is in the 1/0 memory map at location &FEFE, It is possible 
ta send data straight to this location but the correct allophones must be 
worked out and converted to data, Also the program must find out when the 
speech chip has finished saying each allophone by reading from 1/0 locations 
aFEFE and waiting until its value is less than 128, 


The following simple example shows a program to do this, to send this data 
to the speech chip, 


1@ FOR X=1 TO S:REM Length of data statement, 
26 IF INP(2EBFE)>1 127 THEN 2@:REM Wait. 
for chip ready signal, 
38 READ A 
40 QUT &FBFE,A 
SO NEXT X:STOF 
60 DATA 26,16,55,17,99,26,21,@:REM Anstrad 


This example is using the speech chip in its crudest form and requires that 
the component parts of the text to be spoken are converted to data, To do 
this use the allaphone table on page 47, also see the dictionary on page 49, 
An example of the word "COMPUTER" is:- 


WORD ¢ OG M 
1 


FP 
DATA 42, 15, 3, 


7 
6, 435, 22 
NOTE; That at the end of the data we send a @ to the speech chip, this is 
to stop the last sound from sounding forever, 


in 
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2,6,2 USING THE IFEED COMMAND 
This requires that the software supplied is first loaded (cassette version), 


The IFEED command is an extended basic command, This command allows you to 
enter raw data into the speech buffer and ouput it under -interrupt control 
(ie transparent), Once the data is fed into the buffer (this is done in 
fractions of a second) the computer can carry on with its next task, It is 
very Similar to the direct basic mode (see section 2,6,1) and requires that 
the text is converted into data by using the allophone table, See allophone 
table on page 47, 


Example, 


(SPON 


When you enter the above the computer will say DK'TRONICS LTD: - 


See the dictionary on page 49 for other examples or construct your own, 
The maximum number of parameters that the IFEED command can accept is 30, 
The mode of operation is much easier than the direct basic mode but still 
requires that you convert the text into allophones, It has been included in 
the software mainly for sound effects and can be looked upon as the fourth 
sound channel, 


Example, 


(FEED ,62,62,62,62,0 
Will Froduce a pulsating sound 


(FEED, 41,41,41,@ 
Will produce a knocking sound 


You can try any numbers from 5-63 for different effects, 

2,6,3 TEXT TQ SPEECH CONVERTER 

The machine-code software supplied is mainly devoted to this mode of 
operation, Of the 4K of machine code 3.5K is used as tables which contain 


the rules and exceptions of the English Language, 


This is therfore the most important mode and allows speech toa be entered in 
normal English without any converting of data by the user, The software 
must first be loaded, 
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The text to speech uses two new commands: commands, 

ISFON This command turns on the speech interrupts, 

{SPOF This command turns off the speech interrupts, 

PRINT "'Amstrad'" 

The above example is the Syntax for using text to speech, 

Tre ' character after the first speech mark is the control character which 
tells the computer that what follows is not to be printed on the screen but 
to be sent to the speech routines, 


The second ' character is thé end mark, 


All text to be sent to the speech chip in this mode must be enclosed by 
these characters, 


The ' character is the shifted \ key which is to the right of the 7 key 


The text to speech converter is best explained by the following examples, 
Enter this program into the computer ;~ 

1@ ISFON:REM Turn on speech interrupts, 

29 PRINT "'THIS TS TALKING'" 

34 PRINT "'AND SO [5 THIS'" 


Line 1@ is only necessary at the start of the program, 


NOTE; Graphics characters within the text to be spoken will be ignored or 
produce unusual representations, 


The text to speech can handle 96% of all English words, There are a few 
which cause the text to speech slight problens, This is mainly because 
while there are rules for constructing words ie i before e except after c, 
there are more exceptions to the rules of the English Language, These 
problems can all be overcome by slighty misspelling of the word, Type in 
the following, 

{SPON 

PRINT "'SILICON'® 


This word sounds wreng, However, type in 


PRINT "'STLICKON'" 
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The word now sounds correct although it has been misspelt, with some words 
it may be necessary to experiment with spelling although this should be 
rare, Speech can also be sent to the speech chip using string variables or 
even string expressions, 


EXAMPLE ; -— 
1@ LET Ag="'SPEECH'" 


26 |SPON 
36 PRINT A$ 


Pou 


jpeech can be used from the input statement, eg:- 


1® |SFON 
26 INPUT "'WHAT IS YOUR NAME'" | Ag 


Speech can be used using string expressions, egi- 


10 1SPON 

26 FOR 1565 TO 90 

30 PRINT "1; CHRSCI);"'"; 
49 NEXT I 


2,6,4 TEXT TO SPEECH BUFFERS 

The text to speech convertor uses two ram buffers, the text buffer to hold 
the words and the speech buffer to hold the data to be outputted by 
interrupts to the speech chip, 

The text buffer can hold 160 characters while the speech buffer is bigger 
and can held 25@ allophones, It is possible to fill the text buffer and if 
this is allowed to occur then any characters sent to the buffer while it is 
full will be lost, 

The speech buffer will hold about 45 seconds worth of speech and will 
continue to talk after the program has stopped or the break key has been 
used, There are two ways of stopping this, after all 45 seconds of unwanted 
speech could be a bit nauseating, 

If you type in “IFLUS" <ENTER? 

This will empty the buffers and stop all talking, 

OR 

"TSPOF" <ENTER> 


this will stop the talking but leave the buffers with data still in them and 
the last allophone still sounding, 


This could be useful for handling Breaks from BASIC, 


er 
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EXAMPLE 


16 1SFON 

20 ON BREAK GOQSUEB 60 

39 PRINT “'Once upon a time there was a beautiful princess'": 
40 IF PEEKC39614)<200 THEN 40;REM *k 

5 GOTO 3a 

6@ (SPOF:REM Halt speaking of allophones 

74 OUT &FBFE,®:;REM Stop las: sound 

$@ IS=INKEYS 

9@ IF I$=" " THEN STOP :REM Abort is space is pressed, 
190 IF ,I¢="" THEN 80 

116 ISPON: REM Restart speaking af allophones, 

1208 RETURN 


*This value is load address + 14 which you first typed in during loading, 
It contains the amount of space remaining in the buffer, See section 2,7 on 
machine-code, ) 


2,6,5 PRINT MODE COMMANOS 
}OUTM, 1 


This command allows access to text to speech using "'xxx'" only, Listings 
and Syntax errors etc will not be spoken, This is the default setting on 
first loading and using the software, This command is only of any real use 
to cancel [OUTM,2 or {QUTM,3, 


(QUTM, 2 


This command allows access toa text to speech conversion fram all print 
outputs, Anything that outputs to the screen ie listing, Syntax errors etc 
will, be spoken, The outputs will not however, be printed, You can use the 
command to say your listings instead of printing them to the screen, This 
form of listing is fairly slow as the routine will fill the buffers and then 
wait until there is some more room in the buffer and fill if again atc, To 
stop this the routine press the break key and type “IFLUS" then <ENTER> if 
you're fed up with the speech, 


EXAMPLE 
To say a Listing 


{QUTM,2 CENTER? 
LIST CENTER} 


tOUTM, 3 
This command is similar to (QUTM,2 but the output will be printed on the 
screen as well as being spoken, To stop this routine press the braak key 


and type into the computer "IFLUS" then <ENTER> to stap the speech, 
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EXAMPLE 


Ta say and print a listing 


(OUTM,2 and 1QUTM,3 will wait for space in the buffer, 
(QUTM, 1 will not wait and funny effects can occur if some data is lost after 
the buffer fills up, 


2,6,6 THE ISPED COMMAND 


The ISPED,n controls the speed at which the speech chip will talk, This is 
useful as slightly slower sounds on complicated words are easier to 
understand, Type in the following, 


16 ISPON :REM Turn on speech interrupts, 
2@ ISFED,® 

30 PRINT “'THIS IS FAST'" 

40 FOR X=1 TO 5@06;NEXT X 

5@ ISPED,15 

60 PRINT “'THIS [IS SLOW" 


The number that you use after the {SPED command has to be in the range from 
@ to 15, 


The speed can be changed at any point in the program so you can switch from 
fast to slow as you wish, The !SPED,n command also works with the IFEED,n 
command, 


EXAMPLE ; - 


1@ !SPON :REM Turn on speech interrupts, 
26 ISPED,1 

36 (FEED, 26,16,55,17,39,26,21,@ 

40 FOR X=! TO 500@;NEXT X 

5@ ISFED,14 

60 FEED, 42,23,16,9,49,31,17,52,¢6 


2,7 MACHINE-CODE CONTROL 


The speech can be used from machine code in two different ways, The safest 
way is to send data straight to the speech chip at 1/@ memory address &FBFE 
as the speech chip never moves in the 1/@ memory map, To use the text to 
speech routines requires more care as the speech software can be loaded in 
at different addresses, 
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2,7,1 TEXT TO SPEECH MACHINE-CODE CALLS 


ORIGIN INETIALISE ROUTINE 

ORIGIN + Z OQUTPUTS ALLOPHONE IN ACCUMULATOR TO BUFFER 

ORIGIN + 4 OUTPUT STRING POINTED TO BY HL ENDED BY ZERO BYTE, 
ORIGIN + & = [SPON 

ORIGIN + 8 = ISPOF 

ORIGIN + 1@ = IFLUS 

ORIGIN + 12 = ISPED SPEED IN ACCUMULATOR 

ORIGIN + 14 NUMBER OF FREE POSITIONS IN BUFFER 

ORIGIN = LOAD ADDRESS FOR SOFTWARE 


If you loaded the software at 39000 then the (SFON routine is at 39006, 
EXAMPLE OF TEXT TO SPEECH IN MACHINE-CODE 


CALL ORIGINCE 
LD HL, STRING 
CALL ORIGIN+4 
RET 

STRING: DEFE "DAVID" ,& 


The last character in the string must be @ 
If the length of the string is rather long you can check that there is then 


enough space in the buffer by LD A, (ORIGIN+14) the amount of free space is 
in the accumulator, 


EXAMPLE OF CHANGING THE SPEED 

LD A,18 

CALL ORIGING12 

RET 

NOTE IF YOU DISABLE INTERRUPTS (DI) THEN THE SPEECH CHIP WILL STOP TALKING 
UNTIL THEY ARE ENABLED AGAIN (EI) AND ANY ALLOPHONE PRESENTLY BEING SPOKEN 
MAY CONTINUE SOUNDING UNTIL THE (EI) IS ISSUED, 

$0 YOU ARE ADVISED Td QUTPUT A ZERO DIRECTLY TO THE SPEECH CHIP, 

BASIC EXAMPLE 

OUT &FBFE,®, 

MACHINE CODE EXAMPLE 

LD BC, OFBFE (HEX) 

LD A,@ 

QUT (Cx,A 


i hie 
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2,8 ALLOPHONE TABLE 
Pauses 


use before voiced steps and afficates 
use before voiced stops and afficates 
before voiceless stops and voiced 
fricatives also between words 

3 PA4 (106mS) between clauses and sentences 

4 PAS (200m) between clauses and sentences 


Short Vowels - These can be repeated 


7 EH E bend 

12 1H 1 fitting 
15 AX U succeed 
23 AO AU aught 
24 AA O cat 
26 AE A fat 

36 YH 00 cook 


Long Vowels 


SOY ay toy 
BAY Y sky 
ig IY E see 
20 EY EA great 
22 UWt G to 
31 UWe OD food 
32 AW QUO out 
52 0W OW snow 
2E&L LO angle 


R-Coloured Vowels 


Cmonosy] lables) 47 XR AI hair 
5) ER ER computer 
S2 ER2 IR bird 
(nan-monesyllables?) S¢ OR OR store 
SY AR AR farm 
68 YR R clear 


Affricates 


18 


JH J jury 
58 CH CH church 
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Resonants 


Voiced Fricatives 


Voiced Fricatives 


Voiced Stops 


Voiceless Stops 


Nasal 


14 RRI RR read 

39 RRZR brain 
49 YY? WU computer 
25 YYZ Y¥ yes 

45 ib 4 luck 

46 WWW wool 

18 OH] TH they 

54 DH2 TH bathe 
3a WV OV even 

43 22 2 ZOO 


he Mo dy BM ho 
ae mH wo 


bbw 
a See 
“4 


3 2H GE beige 


TH TH thin 
FF fire 
HH1 he 
HH2 hoe 
SH SH shirt 
WH WH whig 
BE] & rib 
BBz B big 
DOT DD cauld 
Db2 0 do 
GG1 GU guest 
GG2 G go 
GG? IG wig 


its 

to 
computer 
sky 

pub 


MM OM milk 
NNT ON earn 
NN ON mo 

NG NG bans 


1 
F 

SS S sat (29,460,55, double for initial position) 
H 
H 
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2,9 DICTIONARY 


alarm 
bathe 
bathing 
brea 
calendar 
clown 
checked 
checkers 
checks 
collide 
cookie 
correct 
correcting 
crown 
daughter 
divided 
engage 
engages 
enrage 
enrages 
escape 
escapes 
equal 
error 

fir 
freezer 
freezing 
gauge 
gauges 
hello 

hour 
intrigue 
intrigues 
investigates 
investigater 
investigates 
key 
legislating 
legislated 
letter 
little 
menor ies 
month 
nipped 
nips 

pin 
pinning 
pledge 
pledges 
plus 


c 
7 
2 
3 
ay 


2, 26,2 2,33,51 
2,45, 
9,7,7 3 
O,7,7 2 
O,7,7 
15,4 
30, 4: 
2,52, 2,17 
2,52, 2,13,12,44 
2,39, 
3,23, 
12, 12,2,21 
1, 2,10 
1, 2,10, 12,43 


1 
6 
6: 
4 
4 
5S 
5 
gi 
3 
4 
4 
4 
3 
= 
Z 
7, 
7 
7 
7 
7 
t 
7 
4 
4 
4 
3 
36 
2 


8,14,19,43,12,44 

6,2,18 

,2,10,12,43 
45,15,53 


} 
1 
5 
S 
2 
7 
$2 
40,14,19,43,51 
4 
2 
20 
Ti 
5 


BURRESS 


12,11,3,13,39,19,1,3 
12,11,3,13,39,19,1,34,43 
12,12.11,35,7,7,58,2,3, 13,12 


,1,36,20,2,13 


12.12.11, 35,7,7,55,2,3,13,12,1,36,20,2, 13,51 
12.12,11.35.7,7.7,55,2,3,13, 12,1,36,20,2, 17,55 


42,19 


45,7,7,2,10,10,55,55,45,20,2,2,13,12,44 
= 7,7,2,18,18,55,55,45,20,2,3,13,12,21 


45,7,7,2,13,51 
45,12,12,3,13,52 
ies 77 Beda 88 
. z 

ao) - .2,3,9, 

fi ,12,12,2,3,9, 
312,12, 11 
3,12,12,11,44 
3,45,7,7,2,10 
9,45,7,7,3,19,12,43 
9,45,15,15,55,55 
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rays 14,7,20, 43 

red 14,7,7,1,21 

robots 14,53,2,53,24,3,17,55 
second 55,55,7,2,42,12,11,2,21 
sincere 55,55,12,12,11,55,55,60 
sincerity 55,55,12,12,11,55,55,7,7,14,12,2,3,13,19 
speak 55,55,3,19,3,41 

spelled 55,55,3,9,7,7,62,3,21 
spellers 55,55,3,9,7,7,62,52,43 
spells §5,55,3,9,7,7,62,43 

started 55,55,3,12,59,3,13,12,1,21 
starting 55,55,3,13,59,3,13,12,44 
stop 58,55,3,17,24,24,3,9 
stopper 55,55,3,17,24,24,3,9,51 
stops 55,55,3,17,24,24,3,9,55 
subject. £5,55,15,2,28,2,10,7,7,3,41,3,13 
sweated 55,55 ,46,7,7,3,13,12,3,21 
sweaters 55,95,46,7,7,3,13,6) 

sweats 55,55,46,7,7,3,13,55 
switched 55,5,48,12,12,3,50,3,13 
switching §5,55,49,12,12,3,50,12,44 
systems 55,55,12,12,55,3,13,7, 16,43 
talked 13,23,23,3,41,3,13 

talkers 13, 23,3,42,51,43 

talks 13,23,23,41,55 

threaded 29,14,7,7,2,21,12,2,21 
threaders 29,14,7,7,2,33,51, 43 
threads 29,14,7,7,2,33,43 

time 13,24,6,16 

uncle 16,44,3,3,62 

whaler 46,20,45,51 

whales 46,260,682, 43 

year 25,60 
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64K and 256K MEMORY EXPANSIONS 


These units are available for the CPC 464, 664 and G128 camputers, 


By using the 64K upgrade the 464 and 664 beet will have the same 
amount and conf aura ten of RAM as the CPC 6125, The 256K gives an extra 
192K on tap of this!, The expansion will nie the use of CP/M+ (R) as 
supplied with the ne 6128 with its massive 61K TFA opening up an even 
larger software base for Amstrad users 


The Ram can be accessed by means of bank switching using a single 1/0 
port, Mamory is actually switched in and out of the 64k 290 address 
Space in 16K sub-blocks, as are the ROMS, The port determines which 
particular combination of the original four 16k sub-blocks and any new 
sub-blocks from the expansion RAM will occupy the 64K address space at. 
any time, Control of the 1/0 part can be from either BASIC or machine~ 
code, 


To use the additional 64K/256K of RAM, the expansion is supplied with 
bank switching software (although it can be switched without this 
software), 


The software adds some extra BASIC commands, RSXs, which make it 
possible to use the second 64K Cor Grd, 4th and Sth in the case of the 
256K expansion)? for storage for screens, windows, graphics and BASIC 
arrays, This ability means that you can write much larger BASIC 
programs, as most of the memory on the unexpanded CFC464/664 is normally 
used for arrays, variables and graphics, 


The additional BASIC commands are;- 


BANK ,n Map a bank of 16K directly into memory space. 
SWAP Alternate between the low an high screens, 
{LOW Change to the low screen, 
{HIGH Change to the high screen, (Default screen), 
ISAVES , n Store a screen to a 16K bank, 
1 LOADS , n Retrieve a screen from a 16K bank, 
ISAVEW,w,n Store a windows's contents into expansion RAM, 
{LOAD,w,n Load a window with data from the expansion RAM, 
ISAVED,n,s,1 Transfer original RAM to expansion RAM, 
{LOADD,n,s,t Load original RAM from expansion RAM, 
IPEEK,n,s,Vv Read the value of a byte in expansion RAM, 
{POKE,n,s,v Change a byte in the expansion RAM, 


These commands make such features as pull down menus, full screen 
animation and large spread-sheet type programs or Data-Bases very easily 
programmed from BASIC as never before possible on the unexpanded CPC464, 
664 computers, 


CP/M+ in & registered trademark of Digital Reeerch Inc, 
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WARNING 


Ensure that the power to your Amstrad computer is switched OFF before 
you fit the interface to the expansion socket, Failure to comply with 
these instructions may cause permanent damage to the RAM pack or the 


computer, 


3,1 Installation 


Fower down your Amstrad computer, Flug the RAM pack into the socket on 
the back of the computer, On the CPC 464 this socket is labelled 
‘Floppy Disc', on the CPC 664 and CPC 6128 the socket is labelled 
‘Expansion', Other expansions such as the Amstrad Disc interface for 
the CPC 464, ODK'tronics Lightpen and ‘Speech Synthesiser, or ROM 
expansions can be fitted into the expansion socket on the back of the 
RAM pack, Now switch on the computer, 


The computer should power up as normal, If it fails to do so, check 
that all the connections are correctly made, Note that all OK'tronics 
products have a key location on the connector to ensure that there can 
be no alignment prablems, OTHER interfaces may not have this keyway 
(the Amstrad disc interface is the most familar axample3, Hence any 
connection problems will usually lie between the RAM pack and these 
expansions, If this is the case, try reconnecting the interfaces BEFORE 
inserting the RAM pack into the computer, This will give you a better 
view when lining up the pins, 


If the computer fails to power up, or crashes on power up (Miscellaneous 


patterns all over the screen!), the monitor may cut out the power to the 
computer, On the colour monitor, just switch the MONITOR off and then 
attempt to reconnect as above, The monochrome monitor may have to 


remain swtiched off for several seconds before power will be reinstated 
to the computer, 


It is very unlikely that the computer will fail toa power up with the RAM 
pack alone, If this is the case, then the fault will probably lie with 
the RAM pack, + Return the RAM pack to DK ‘tronics if this is the case, 


* IT 15 ESSENTIAL THAT YOU COMPLETE YOUR WARRANTY REGISTRATION CARD AND 


RETURN IT TO US IMMEDIATELY WPON FURCHASING THIS PRODUCT FROM YOUR 
DEALER (UK ONLY), 
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3,2 USING YOUR EXTRA RAM 


There are twa ways to use the extra RAM, There is a cassette supplied 
with the RAM pack containing extensions to BASIC, Here the extra RAM 
can be used simply from BASIC programs, Alternatively, the RAM is 
accessible both from BASIC and machine code using the OUT command, The 
experienced programmer will be able to use the RAM for whatever he 
pleases and write custom software for that purpose, Commercial programs 
will no doubt use this approach, 


The second method is described in detail in section 3,10, The first way 
is explained in the following chapters:- 


With the computer set up as above, load the RSX software from the 
cassette tape supplied:~ 


On disc systems type '{TAPE' and press <ENTER?> 


bd Type 'RUN' and press <ENTER> , 
t? The loading sequence is described in detail in your Amstrad user 


manual, 
d)} When the program has finished loading, you will be asked to enter 
a loading address, Just press <ENTER> for now, (See section 11,) 


e)} The computer will test the RAM and then print out how much RAM 
you have got, then the computer memory will be clear ready for 
your awn programs, 

The cassette tape contains the same programs on both sides so that if 

one side fails to lead, the other is there as a backup, 


Subsequent programs on the cassette areextracts from this manual which 
may be loaded from tape if you do not want to type them out, 


3,3 RAM TEST 


When the RSX code is first loaded, it does an extensive RAM test, 
Should the RAM not function correctly the program will inform you that 
an error has been found, Along with this, it will print out diagnostic 
information to help in the repair of the RAM pack, 


In the unlikely event that an error is found, please note the 
information that is given and return the RAM pack for replacement or 
repair, (See warranty registration note page 52,) 


3,4 EXTENDED BASIC COMMANDS 


There are a total of twelve extra commands provided by the RSXs on tape, 
Some may have parameters, some will not, Sometimes the command may have 
different formats and numbers of parameters, We have tried to discuss 
each command in its simplest form and later sections will describe added 
Parameters which make the command more flexible and economic on memory, 
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You may have noticed that during the RAM test, the computer printed out 
the number of the ‘bank' if was testing, Each bank is 16K of memory, 
For the 64K expansion there are 4 bankswhile the 256K RAM pack has 16 
hanks, To access a particular part of the expansions's memory there has 
to be a bank number and possibly a bank address, 


For example, type:- 'ISAVES,1' and press <ENTER> 


The computer will respond with READY, What you have done is to store 
what was on the screen into bank 1, 


Now clear the screen using CLS, Ta get the screen's contents back, 
type:- 'ILOADS,1' and press <ENTER? 


You can save as many screens as you have memory for, That means four 
screens on the 64K RAM and sixteen screens for the 256K RAM, 


Screen displays could be created from another program or drawn using a 
lightpen, Store these on tape or disc then load then back into RAM for 
use throughout the program, Screen displays which take a long time to 
create within a program, for example mazes, can be created once, then 
stored for instant use whenever necessary, 


The command can be summnarised:— 


ISAVES, ECbhank] save data to bank 
ILOADS, Cbhank] load data to bank 


3,5 WINDOWS AND PULLDOWN MENUS 


One of the features that makes the Amstrad's windows less flexible than 
those on larger business machines, is the fact that the contents of a 
window which overlaps another are lost when the other window is used. 


There are two new commands which allow the contents of windows to be 
saved and reloaded from RAM, This will allow the use of true pulldown 
menus, that can cover text, but not remove it, 


EXAMPLE ; ~ 
NEW 

16 MODE 1 

26 FOR i=0,05 TO 1 STEP 0,65 ; REM Draw grid on screen 
38 MOVE £46%*1,0 ; DRAW 640%: , 400 

49 MOVE ©, 40041 ; DRAW 646, 400%i 

5@ NEXT i 

64 WHILE INKEY$="" . WEND ; REM Wait for a key press 


78 WINDOW, INTCRNDOT419+19, INTCRND(@)49+INTCRNDC 1 45+179), 
INTCRND( 1414413, INTORND(Q)414+INTCRNOC 1941645) 

SO PEN#1,2 ; PAPER#1,3 

9@ (SAVEW,1,1 ; REM Save contents of window into RAM 


188 CLO#l : REM Clear window 
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118 WHILE INKEY$="": REM Wait for 2nd key press 
120 PRINT#1, “This is a window" 

138 WEND 

146 |LOADW, 7,1 : REM restore window's contents 
158 GOTO &e 


The above program uses two new commands: (tLOADW and {SAVEW, iS you are 
probably aware, there are eight windows (9-7) which can be defined, The 
first parameter is the reference to a window, The second is the bank 
mumber , 


[SAVEW, Cwindow numberd, Ebank} save window to bank 
[LOADW, Cwindow number], Cbhank] load window from bank 


See the chapters in the user manual about window for more details, 


3,5,1 MORE WINDOWING 


A window of any size, even the whole screen, will fit into a single bank 
of expansion RAM, This is fine if your window is nearly a full scraen 
or will vary in size like the above example, On the other hand if your 
window was defined as 10 « 18 in Mode 1, then the amount of memory 
needed to store this window would be less than 16k, In fact only 1600 
bytes are needed (see below), Thus to use a whole bank would mean 
wasting over 14k of memory, 


To deal with this problem, the RSX window command can take an extra 
Parameter to define where you want the window's contents to reside in 
the RAM bank, In the 14 x 16 window you could place the data anywhere 
between 0 and 14783, The command can be written:- 


ISAVEW, Cwindow number], Coankd, Cbank address] 
ILOADW, Cwindow number], Cbhank], Cbank address] 


The bank address ia an address between @ and 16333, The amount of data 
in bytes used to store a window needs to be taken away from the top 
value and this leaves the range between which the data can be stored, 
If you put the data at the bottom of tha RAM bank, at address 6, then 


the memory from 1660 to 16382 is free for other windows or data arrays, 
HOW TO CALCULATE A WINDOW'S SIZE 


In order to have more than one window per bank, you need to know how 
much memory the window will take up, If the window will vary in size 
between two limits, use the higher of the two, Depending on which mode 
you are using, the figures are calculated as below, 


In each case; X1 is the left most « coordinate 
X2 is the right most x coordinate 
Yl is the top y coordinate 
Y2 is the bottom y coordinate 
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MODE 0 SIZE=(X2-X1+1) & a & CY2-YI41) ¥ S 
MODE 1 SIZES(X2-X14+1) ¥ 2 * CY2-YI+1) # 8 
MODE 2 SIZEs(X2-X141) ® C¥2-Y¥I4+13 #8 


The computer will give an error if the window is too large to fit in the 
space you have allotted for it, Also if the size is mis-calculated the 
windows may overlap in the bank and cause strange effects, 


EXAMPLE 2;- 


1@ FEN 1; PAPER ® ; MODE 1 

20 size=14 * 2 * 1048 

309 LOCATE 1,13 >: PRINT “ 'n' for new window ‘d' to remove window" 
46 WINDOW 1,14,1,10 ; PAPER 3; CLS 

50 bankaddress=@ : level=0 

68 PRINT#lavel, “Window"; level 

76 keypress#=LOWERS( INKEY$) 

50 IF keypress$="n" THEN GOSUB 110 

90 IF keypress$="d" THEN GOSUB 190 
168 GOTO 68 
116 If lével=7 THEN RETURN 
129 level=level+] 
156 WINDOW# level, 1+level#3, l4+level#3, l+levelk2, }@+levelk2 
149 |SAVEW, level, 1, bankaddress 
150 bankaddress=bhankaddress+size 
160 PEN#lavel,@ ; PAPER#level, (level AND 1)+1 
CLS#level 
RETURN 

IF level=0 THEN RETURN 
a bankaddress=bankaddress - size 

(LOAQW, level, 1, bankaddress 

lavel=level-1 
RETURN 


The above program only uses one bank of RAM but all & windows are 
defined, The variable ‘level' is used to stand for the level of windows 
and the variable ‘bankaddress' points to the next free place in the bank 
RAM, 


3,6 ARRAYS, VARIABLES AND STRINGS 


There are two general purpose data moving commands to allow data from 
the program to be moved ta and from the RAM pack, 


These twa canmands are:- 


rt location}, Clength], Cbank address) 


ISAVE, Chank], CStar 
(Start location], Clength], Chank address 


ta 
{LOADD, Ebank], (St 
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The first parameter references which bank you want to use, The start 
location is a memory address where there is some data, The amount of 
data is given as the length, Optionally a bank address can be given to 
allow more than one type of data to be stored in the RAM, 


It is possible to save all kinds of data using these commands, but we 
will firstly discuss how to save simple numerical arrays these being the 
aasiest to understand, 


Say for example that your program deals with stock control of up to 66 
items, You may have a string array containing the names and a numerical 
array containing the number of each iten you have in stock, 


This would use about IK for the names and 200 bytes for the stock 
fugures, However what if you update the stock value every week and you 
want to keep the last year of stock on record! Or even the last five 
years, Now the figures would take up about 15K or even 75K, 


These could be comfortably stored on disc, or even tape for a year's 
stock, and the data read every time a calculation was needed, but you 
will probably agree that a long time would be spent waiting for reading 
the data each time a distribution is calculated far each item, 


Obviously, it would be easier to load all the records into RAM, then 
access the data immediately:- 


Instead of defining an array of dimensions ‘stock(60,52)' taking over 
iSK of valuable RAM which could be used for programs, define and array 
‘stock(60)', Read all the data from disc a week at a time, and store 
aach week of data into bank RAM, To do this you need to know two 
things, One, where does the array lie in memory? and two, how many 
bytes is it necessary to save? 


1) Where is an array stored? 
The address of any variable can be quickly found using the '@' before a 
variable, For example, dimension the above array:- 

DIM stock (60) 


Now type: PRINT @stock(@) 


The computer will reply by giving the memory address where the first 
alement of the array is stored, Try:- 


PRINT @stock(1) 


The number returned will be five higher in value, This is the address 
of the second variable, 


The '@' prefix will work in front of any variable, The first item of an 
array is obviously ‘@stock(d), If you are using multi-dimensional 
arrays, the first item is ‘@stock(9,0)' or ‘@stock(6,0,6,0)' depending 
on the number of dimensions, 
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2) How long is an array? 


First of all, different types of array take different numbers of bytes 
per element, For real numbers, there are 5 bytes per element, Integer 
arrays take 2 bytes per element, String arrays are of variable length, 
And will be dealt with later, 


Next, the number of dimensions and elements needs to be taken into 
account, Remember that alements start from @, This means that an array 
of ‘stock(6@)' has 61 elements, Whether or not you prefer to use the 6 
elemant is up to you, but if you forget it, there could be some 
unexplainable bugs appearing in your program, Once you know the real 
number of elements in every dimension, simply multiply together all the 
dimensions to find out the total number of elements in all dimensions, 


For example: ‘stock(66)' has a total of 61 elements 
‘stack(60,523' has 61 * S3 elements = 3 elements, 
‘stock¥(18,5, 12)! has 1} * & * 13 elements = 858 in all, 


To find the total memory, multiply the total number of elements by the 
amount of memory needed by each element, 


For example; ‘stock(66)' takes 61 * S = 365 bytes, 
‘stock(60,52)' takes 3233 % 5 = 16165 bytes, 
‘stock4(10,5,12)' takes S58 * 2 = 1716 bytes in all, 


The array we are using is 304 bytes long, and starts at @stock(@), Ina 
Single bank of Ram we can store 365 bytes atout 52 times, The bank 
address starts at @ and goes up in steps of 305 bytas:- 


& 205 616 915 1220 1525 etc, 


We shall store week | at bank address 305, week 2 at address 610 and so 
on for all 52 weeks, 


Data for test purposes could be written onto disc or tape by the program 
below, Once the test file is written, keep it for use while you are 
developing your program, 


16 OPENOUT "stock dat" 
20 FOR week=1 TO 52 
39 FOR item=1 TO 66 


5 Print#9@, INTCRND(1343006+100 3 
4g NEXT item 

68 NEXT week 

78 CLOSEOUT 

86 END 


——————$$ £@@ —— 
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Now type ‘'NEW' and enter the following program: 


Te CIM stockC6e) 
26 INPUT “read file Cy/ni“ sans 
30 IF LOWER$¢ans#)="y" or LOWER¢ (ans$)="“yes" THEN GOSUE laos 
40 REM rast of program 
1800 REM subroutine to read data from disc, 
1910 OPENIN “stock dat" 
g20 FOR week=1 TQ 52 
FOR item=1 TO 6@ 
1448 INPUT#9, stockiten? 
1958 NEXT iter 
5 {SAVED 4,@stock(@) 6145, week * 
1070 NEXT week 
% CLOSEIN 
RETURN 


The above program could be used to read the file from disc or tape, 
Once the file is in bank RAM, the contents will stay there far use until 
the computer is switched off, or some other data is put in that bank, 
This means that data need only be read once from disc, then the program 
can be rerun without losing the data, This could also be useful too if 
you wish to write 4a number of programs to use the same data, 


Once the data is in memory, you can access each week's data simply by 
reloading the stock array, Add the section below to draw a bar graph 
for a given section, 


198 MODE 2 
11@ LOCATE 1,1 
720 INPUT "Which item to analyse", itemno 
136 IF itemno<) OR itemno>60 THEN 126 
140 CLS ; LOCATE 36,1 
150 PRINT “Bar Chart For Item“; itenno 
160 LOCATE 16,25 
17@ PRINT" Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nav Dec": 
REM 3 spaces between each, 
180 FOR loop=@ TO 4 
190 LOCATE 1,24~loop*s 
200 PRINT STRS( loop); "600" 
219 NEXT loop 
228 MOVE 64, : DRAW 60,9 : DRAW 61,9 ; DRAW 61,365 ; 
MOVE 640,24 ; DRAW 43,24 
@ FOR loap=1 TO 4 
MOVE 42, loopxte+24 ; DRAW 60, loopkset+24 
NEXT loop 
® FOR week=1 TO 52 
If week /e=week/2 THEN n=] ELSE n=2 
ILOADD,4,@stack(@), 6145, week #305 
ycoord=( stock Citemno}/4G00*320 3 AND 4092 
FOR xcoord=1 TO 11 STEP n 
MOVE 49+xcoordt+tweek4}}, ycoord+26 : 
DRAW 49+ xcoord+week Xl], 26 
) NEXT xcoord 
36 NEXT week :GOTO 116 
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3,6,1 MORE ARRAYS, VARIABLES AND STRINGS 


Tf you have a program that uses all the memory of the computer due to 
needing a large array, you can use the bank RAM for storing data without 
even dimensioning an array. 


For example if you have a two dimensional array ‘sales4(365,20)' to 
store the amounts of cartain types of stock you sell for each day in one 
year, Even though you are using intergers, the array uses over 22K of 
manor y , 


Instead of having the whole array in BASIC memory, each element can be 
accessed by using a subroutine to read out a value, and one to store a 
value, 


10006 REM load ‘stores’ from bank memory using 'year' & ‘type', 
1010 p= yeart3}+type dee 
bO20 bank=? ; IF p >=16000 THEN p=p-16060 : bank=2 
10938 {LOADD, bank, @store%, 2, p 
18046 RETURN 
11006 rem copy ‘storex' toa bank using ‘year' & type! 
11918 pHt yeark3ittype *2 
11020 bank=1 ; IF p >=16000 THEN p=p-16000 © bank=2 
119630 (SAVED, bank, @store%,2, p 
1164 RETURN 


Two banks are used, 1 and 2, and the variables ‘year' and ‘type’ are 
used to reference which element is required, On line 10036 and 11836, 
there are just 2 bytes moved to and from the bank RAM because we are 
using integers, The '#2' in lines 10010 and 11910 reflect the fact that 
an integer is stored in two bytes, If real variables were used, 5 bytes 
would nead to be used instead, Lines 10020 and 11620 decide whether the 
element is in the first bank or the second, 


If the array is to be filled with data from tape or disc, there is no 
need to initially clear the values to nil, If you want all elements 
preset to zero then the easiest way is to save a blank screen into each 
bank at the start of the program:- 


1 
t 


: PAPER @ ; CLS 


2,6,.2 STRING STORAGE 


The major obstacle in storing strings is that they can vary in length 
and can be stored anywhere in manory, including in a BASIC program, One 
mathod of storing string arrays is outluned below, However you may find 
an easier way to store strings than the one described below when you 
consider exactly what you want to do, 
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Suppose that you wanted to store 56@ names, up to 209 characters long 
each, A bank is seperated into units of memory 21 bytes each so that 
strings can be randomly accessed, In each 21 byte segment there is one 
string, and one byte to say how many letters there are in that stirng, 
That means that we will use a toal of just over 1K, If we use the 
variable ‘name’ to specify the string we want then we can enter two 
subroutines one to put a string from bank 1 into ‘name$' and one to 
store the contents of ‘name$' into RAM bank number 1:- 


go REM assign ‘name$' to string number ‘name’ 

310 boa" “ . REM 2] spaces 

(LOADD, 1, PEEKC @b$+] )+PEEK( @b$+2 04256, 21, namek2] 
Namef=MIDS(bS, 2, ASCCbS) 2 + RETURN 


21006 REM Store 'name$' in bank as element ‘name’ 

21610 b=! "+ REM 21 spsaces 

z MID$* b$,1, 21 J=CHR#C LENCname$) )+names 

2103@ SAVED, 1, PEEK( @b$+] D+FEEKC @b$+2 24286, 21, nameXe) 
® RETURN 


A dummy string b% is used to form the element before it is saved into 
RAM, The first character is set to the length of ‘name$', The latter 
26 characters are where the contents of ‘name$' are stored, Then 21 
characters are copied into bank RAM, When the string is retrieved the 
characters are copied out and ‘name$' is set to the right length by 
looking at the first character, 


String storage would come into its own if all the words were of the same 
length because there would be no wasteage, For example a word quiz 
program using five, six and seven letter words, A bank of RAM could be 
used for each length of word, A loader program would set up the data 
inte the RAM, then another could be CHAINed and use up to SéK of RAM for 
program, 


A number array could also be stored in bank RAM to index the first 
letters and So aid the speed of access to a particular word, 


TELAT 
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3.7 ANIMATION AND PICTURE SHOWS 


We have seen how screens and windows can be stored and retrieved, 
Animation is the act of putting pictures on the screen Quickly enough so 
that the eyes see something move, With 64K or 256K of memory whole 
screens can be stared away, then put on the screen to Produce animation, 


You may have noticed in section 4 that when a screen loads onto the 
screen, you can see each line appear, To illustrate, type in the 
following program:~ 


16 MODE | 

24 BORDER © 

30 FOR col=6 Ta 
43 INK co1,6 
58 NEXT col 

59 FOR col=0 TO 3 

70 PAPER col +: CLS 

BO ISAVES, colt] 

90 NEXT col 

96 INK 8,1); INK 1,6 : INK 2,21): INK 3,13 


a 


106 

116 PEN 1 + PAPER 3 

12@ WHILE INKEY$="" 

13 FOR screen=) TO 4 
146 {LOADS, screen 
150 NEXT screen 

168 WEND 

170 END 


The program saves four coloured screens into bank RAM, then loads then 
up in sequence, Unfortunately, the effect is a striped pattern, 


In order to create animation which is easy on the eye the computer needs 
to create the screen display, then instantly display it, 


Three new instructions that allow this ta be done are;- 


HLOW, IHIGH and |SWAP 


Before the commands can be understood it is necessary to know how the 
Amstrad's screen can be used, The normal screen is located at 49152, 
However the Amstrad is capable of viewing a screen anywhere in memory in 
TEE blacks, The first block at ®@ and the third block at 32768 are 
difficult toa use for screen as the computer uses these as part of the 
BASIC interpreter, The block of memory at 16384 is free for use as long 
as GASICS HIMEM is lowered to below 16384, Using this, we have called 
the original screen the high screen and the new screen at 16384 is 
called the low screen, To ga from one ta the other just use:- 


LOW to set the low screen in action 
IHIGH to reset the high screen 
{SWAP to swap from low to high and vice-versa 


— 
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Whenever the swap is made, the computer is told, and all further text 
and graphics appear on the selected screen, 

To use this facility of swapping from one screen to another instantly, 
the screen and window commands can fave an added parameter which tells 


thea computer toa load or save the data to and from the alternate screen, 


The new forms can be written:- 


ISAVES, C bank 3, C swap J 

(LOADS, £ bank 3, [FC swap 2 

ISAVEW, C window number J, [€ bank 37, € bank address 3, (C swap J 

TLOADW, C€ window number 7, ¢ bank 7, £ bank address J, C swap ] 
If the swap value is zero, by default, then the command will act on the 
screen that is presently being displayed, lternatively, if the value 
is one the computer will load and save data from the screen which is not 
being displayed, When the work is done, the computer can swap screens 


and the effect is that the screen appears to change instantly, 
In the above program type these lines:- 
& MEMORY 163 THIGH 


138 IF screen\ screen/? THEN t=TIME : WHILE TIME <t+2@ ; WEND 
146 (LOADS, screen, | ; |SWAP 


Now that the computer can build up the screen while another is being 
displayed there is no pattern, The coloured screen appears to change 
instantly, 


Que to the fact that the bank memory moves into the address space at 16K 
it takes longer for the transfer of screens to be made to the low screen 
than ta the high screen, Hence line 135 delays the computer as it is to 
load the high screen, This means the time each screen is on the screen 
remains the same, Try removing line 135 to see the difference, 


If a longer delay were to be put between line 140 and 150 you would get 
a picture show effect, Alternatively, you could select screens when a 
key iS pressed, 


On a small scale, a window could be defined and graphics could be 
rapidly displayed without resorting to swapping screens, 


Note, that of less use is the fact that the contents af screens and 
windows can be saved from a screen which is not on display simply by 
adding a one for the swap parameter, For example if you want to load a 
series of screens from tape ar disc, load then into the low (16K) 
screen, Messages generated by the tape system need not be switched off 
as the screen's contents will not be changed in the low memory screen, 


1@ LOAD “screent",t6384 ; (SAVES, =, 1 


The above will load a screen then save it to bank 3, The screan the 
user sees can have something else on it, 
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3,8 ADVANCED PROGRAMMING 


This section introduces one new command and some other programming 
aspects which you may find useful, 


The new command is:- 
TASKRAM, C anquiry 1, £ variable ] 


The conmand allows certain constants to be found by the pragram you are 
writing, For example if can return the number of banks available to the 
Program as this will change depending on whether you are using the 64K 
RAM pack or the 256K RAM pack, The ‘enquiry’ value is a number | to 3 
which selacts what you want to know, The answer is placed in an INTEGER 
variable defined by the second parameter, 


1000 a%=O ) IASKRAM, 1, @a% ., will assign a% to the amount of RAM 


1188 a%=6 : }ASERAM, 2, @a% ,. will assign a% ta the number of 
banks 
1200 a%=G | IASKRAM, 3, @a% ., will set aX to @ ar 1 depending on 


whether there is a problem with the RAM 


The last command can be used to make sure the RAM 1s there and ready to 
use if in your programs you do not want to have to load the RSX loader 
first, It 1s possible to load just the RSX machine code on 3ts own:- 


MOCE 1 PRINT “Program Loading’ " 


T=HIMEM 
MEMORY 3999 
£@ LOAD ‘rsx" feted 
Te[-¢ PEEKC 1@604 %+PEEKS 2 
@ FUKE io T-INTC ise 


Y PORE 1000 INTC P7256 9 
PRINT CHR. 367: CHRS( 27 + 
Om CALL 1eaad 
PRINT CHG ae 


aa ; Man 

IF ar THEN FRINT "RAM is faulty’ +» END 

CLEAR : MEMORY FEEK¢ Y+4PEEK( 1QG02 IK2SE~) 
O CHAIN "parte" 


The program above will load tne RSX machine cade and put it inte memory, 
Nothing will be printed on the screen goless the RAM proves to pe faulty 
or not even there! The program ‘parto' would be the bulk the 
Program, Loadng the program in two parts saves reloading the REX code 
every time the program 1s run 


7 


The code has to be loaded in at nory before if is relocated 
for use, The 16 bit value in iacations ? and | is the place you 
want the code be located at, Another 16 bit value in ioacations 


vm 


16084 and 1eees Whains the length of the code which 1s moved higher in 
met ‘ ieoof the program is only need once - the relocatis 
the RAM test programs, and hence this part is not maved higher in RAM, 
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Tf you want to use user defined graphics then add the following lines:- 


16 SYMBOL AFTER 256 
158 SYMBOL AFTER 9 


The value in line 156 will be different depending on how many user 
defined graphics you want, 


In your program you may want to have a number of different styles of 
character set, After you issue a SYMBOL AFTER command, HIEMEM is set 
just below the user defined graphics, Hence it is possible to use the 
1LOADD and iSAVED commands to move graphics to and from the graphics 
characters, 


If you have a program that defines the character set, the definitions 
can be saved and loaded into bank RAM so that a program may have 
multiple chartacter sets, 


19 SYMBOL AFTER ® 

28 chars=HIMEM+] 

30 REM define symbols here 

1400 SAVE "“setl.grp", B, chars, 2048 


This program will save you character set onto disc or tape, 
On your final program you may wish to load a number af sets:— 


19 SYMBOL AFTER 

2@ chars=HIMEM+1 

20 LOAD "seti,grp", chars ISAVED, 1, chars, 2048, @ 

49 LOAD “set2,grp", chars SAVED, 1, chars, 2048, 2043 
56 LOAD “set4d,grp", chars : ISAVED, 1, chars, 2048, 4096 


The reason the variable 'chars' is set up is because the value of HIMEM 
alters when the disc or tape is accessed, 


During the program, a subroutine could be used to select a character 
seti- 


160@ REM given the variable ‘set', load the characters 
1918 ILOADD, 1, chars, 2048, ( set-1 )*2048 
1626 RETURN 


Note that the variable ‘set' is used, In the above loading sequence 
sets | to 3 will be valid, More or less could be added as it suits you, 


All of this setting up can be done on the loader program, just once, 
When the program is subsequentiy run, there is no need to re-load the 
bank RAM, 


AMSTRAD MEMORY EXPANSION 66 


DK‘ tronics manufacturers of powerfull peripherals 
ss 


The setting of chars can be found whenever needed by:- 
2@@ CLEAR : SYMBOL AFTER 6 : chars = HIMEM+] 


This will remove any disc buffers that have been set up and ‘chars' will 
indeed point to the characters, 


3,9 PEEKING AND POKING 


There are two commands which allow the memory in the banks to be viewed 
and changed byte by byte, 


IPOKE, C bank 3, £ bank address 1, € value j 
IPEEK, C bank 1, £ bank address J, C variable ) 


IPOKE works in a similar way ta the original POKE, You need to supply a 
bank number in addition to the normal address and value, The bank 
address is in the range @ to 16383 or @ ta 16K, 


{PEEK is a command rather than the normal function, The bank and bank 
address are the same as for IPOKE, To find out the value, you need to 
supply an integer variable in a similar way to the IASKRAM command , 


For example:- 


19 valuer=@ 
20 IPEEK, 3, 12345, @value% 
30 PRINT values 


The above will read the byte from location 12245 in bank number 3, The 
@ character tells the RSX extension where the variable is in memory 50 
that its contents can be changed toa the byte required, 


{PEEK and IPOKE are not really commands for the beginner, in fact they 
have only been included for the more advanced Programmer who wishes to 
use the bank RAM in his own way, 


Another advanced command which has been included for the experienced 
programmer is IBANK, 


BANK, C€ bank number J 


The command is followed by one parameter, If this parameter is not 
Present, a zero is assumed, The bank referenced is mapped into the 
address space at I6K to 32k, A bank number of zero will map the 


original RAM back in, numbers | to the maximum bank number will fap that 
bank into the address space, If a bank is mapped in, the computer will 
use the bank memory istead of the normal RAM, However, the screen will 
still be taken from the original RAM if [LOW was issued, The advantage 
of this is that the whole memory can be used for programming instead of 
having to set the top of memory to 16383, The disadvantage is that if 
the program is halted while the low screen is being displayed, the 
computer will write screen data into the BASIC Program - causing chaos, 


——— OO 
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Make sure you are accustomed to using IBANK, IPOKE and IFEEK before you 
risk creating a large program using them, Save the program frequently 
in case you make a mistake and lose your work, 


3,1@ PROGRAMMING WITHOUT RSXS 


With no RSX software the programmer can still access the memory from the 
RAM banks, To use the RAM yourself, some degree of understanding of the 
memory map of the Amstrad is necessary, 


From both BASIC and machine code, the original block of memory from 
16384 to 67 CANNOT be used for program, Hence in BASIC, you need to 
set the top of memary to 1 Machine code is free to use any memory 
that it can normally except the black mentioned, 


The extra RAM is wapped into the addresses 16364 to 32767 in 16 
banks.Once the bank is mapped in, you can do anything with the RAM you 
normally would, It is inadvisable ta use the bank RAM for machine code 
because if you subsequently change the bank, the program disapears! 
Nevertheless, programs can be written to run in banks and indeed in the 
original I6K block that is banked out, but it is necessary to do the 
bank changing outside of this memory range, In BASIC it would be 
extremely difficult to use the banked RAM for extra programs, but not 
impossible, but we shall leave that possiblilty up to you! 


Tha way that banks are selected is defined below;- 
IN BASIC: Where ‘'bank' is the number of the bank to map in 
QUT &7F80, 196+¢ bank AND 3 04+ bank AND 28 242 
NOTE: the bank numbers in this case START AT @ 


For 64K expansions the banks are ® to 3, On the 256k, bank numbers are 
@ to 15, 


To reset the original bank :- 


OUT &7F88, 192 
IN MACHINE CODE; Where the bank number is in the accumulator, (A) 


SELECT: PUSH BC : select bank A (save all registers except a 
LO C,A ; and flags) 
AND 3 ; bank AND 3) + 
LO 6,A 
LD A,c 
AND 28 s¢bank AND 2B9x2 
ADD A,A 
OR B 
OR 196 , + 196 
LD BC, ®7F90H ;BC=87F 00 
OUT (C3,A 
POP EC 
RET 


a 
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Again the bank number in the accumulator starts at 9, Ta reset the 
original bank :~ 


RESET; PUSH BC ; Peset original memory 
LO BC, @7F@6H ;BC=R7F 08 
LD A, 192 
OUT (C>,4 
POF BC 
RET 


3,71 TECHNICAL DETAILS 
3,11,1 The Load Address 


The software which loads from tape is relocatable, However the areas of 
memory in which the program can go is limited to between B2768 and the 
top of memory, This is because the banked RAM appears in the block 
16384 to 32767, (See previous chapter for explanation of why!) Below 
the 16K boundary, the RSX command table will no longer funtion, Hence, 
during relocation, the code is loaded at 14000 in memory and moves to a 
Place higher in memory, Pressing <ENTER> while loading, will 
automatically select the highest location available, Alternatively you 
may wish to load the code to a lower address and reserve same space for 
your own pragrans, 


3,11,2 Saving to Disc 


The software oon the cassette is NOT protected, Hence to save it onto 
disc or even onto another tape at speed wite | is a matter of loading 
the data into memory, then saving it, 


1) Type 'ITAPE' and press <ENTER? Cfor disc systems) 
LOAD “bank " 

MEMORY 9999 

4) LOAD “rsx" 
5) Type '1DTSC 
6) SAVE “bank " 
7) SAVE "rsx", 6, 10000, aged 


Katy 
or set SPEED WRITE as desired 


3,171,323 INCREASING CP/M 2,2 TPA 
Run the program called "TFA" from either cassette or disc, depending if 
you have a 464 or 6128 computer, When instructed to, place a CP/M 2.2 
system disc into drive A, 
The program will now write a file called INCTFA COM to your system diec, 
Boot up CP/M 2,2 then inmediately after the 'A>' promt type in INCTPA 
then press <ENTER>, Your system disc will now be altered to have a BIKE 


TPA, 


This routine will only be required to run once, 
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Commercial Program Compatability 

The RAM expansion is compatible with the banked RAM supplied as standard 
with the CPC6126, This means that a number of programs wirtten for the 
CPCE128 will now work on the CPC464/664 computers, 

In fact the RSX software provided will work on the CFCE125 where the 
256K expansion will give 320K of banked RAM, 


The bank switching software in its supplied state will only access 256k 
of banked memory, that is 16 banks, If you add more memory or have the 
CPCE128 with a 256K memory pack, the RSX software can be told to 
access a full 512K of banked memory (32 banks? by poking location 10006 
with 1, See section 8 for explanation of how ta load the RSX software 
on its own, 


55 FPOKE 10006, | 
This line will do the trick! 


If a commercial program fails to work on your CPC464 or CPCHE4 then try 
the suggestions belaw, 


1) The software may be using the new firmware vector at &BDSE, If this 
is the case, try running the RSX program before running your 
application program, 


Some programs which will function correctly after the R5x software 
tape has been loaded in are Tasman's Tasword CR) word processor, Tas~ 
spell and Tasprint for the CPCE128, In conjunction with these, 
Campbell Systems! Masterfile 128 will provide a 64k filespace and 
interfaces with Tasmans's software, 


be 
od 


Some software, whether loaded from disc/tape or booted from a 
background ROM will check the ROM identity by using the firmware 
call &B315, 


There is one more command included in the RSX software on tape which 
will cause a CPC464 or 664 to amulate the ROM identity of the 
CPCBHIZE, 


Type ‘IEMULATE' and press “ENTER? 


Any programs that call the ROM identity routine will mow be informed 
that the computer is a CPCEIZE8 and may now work correctly, 


3) The software may use some features of the CPCE&I22 ROM which are 
unavailable on the CPC464 and CPCEE4 machines, In this instance, you 
may be able to get information on how the program can be altered to work 
en the CPC464 or 664 from the manufacturers of the program in question, 


3.11.4 Using CP/M 2,2 (R) 
CP/M 2,2 (R) as supplied with all Amstrad computers will function as 


normal with the Extra memory fitted, However if you rum the INCTPA,COM 
utility the TPA available to CF/M 2,2 will be increased to GIF, 
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Programs of your own devising written under this aperating system are 
free to use the extra memory, See section 3,10 for details of how to 
use the extra memory from machine code, 


3,12 ERROR MESSAGES 


While you are using the RSX software, there will te some accasions when 
the computer does not understand, or cannot carry out what you have 
instructed, The software may issue some errar messages in addition to 
the normal messages that the computer will give, The errors and why 
they are likely to occur are outlined below:- 


1) Bad bank command Given if you have given the wrong number of 
Parameters or if a variable is not present. 
where there should be one, 


2) Bank unavailable You have tried ta access a bank which is nat 
Present on your system, 


3) Bad bank parameter You have referenced a bank which can never be 
fitted to the computer, 


4) Bad bank address The address you have given is out of range: 
bank addresses range from @ to 16383, 


5) Value invalid The bank address may be too large for the 
block of data defined, The parameter for 
[ASKRAM is other than 1, Zor 3, The size or a 
black to be saved is larger that 16K, 


6) Bad window definition The window referenced in ISAVEW or ILOADW 
i§ above 7, 


3,13 REFERENCE OF RSX COMMANDS 


All the additional commands are listed below as a reminder to their 
functions and syntax, 


SCREENS 


[SAVES, £ bank 7, £ swap J 
iLDADS, € bank 2, C swap 1 


WINDOWS 


{SAVEW, EC window number], C bank 3, € bank address 1, € swap J 
ILOADW, C window number], £€ bank 7, € bank address 1, ( swap ] 


DATA BLOCKS 


HSAVED, C bank J, ( Start lecation 7, € length J, ( bank address 1 


=> 
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ANIMATION 


{LOW Clow screen) 
{HIGH CHigh screen? 
{SWAP (Alternate between High and Low screens? 


OTHER 
IFOKE, C bank 7, C bank address 1, € value J 


IPEEK, € bank J, C bank address 3, C variable ] 
(BANE, £ bank J 


IASKRAM, C equiry J, C variable J ¢C enquiry 1, 1 = RAM, Z@ = banks, 
3 = error occured?) 
DEFINITIONS 
{ bank 7 Bank number 1-4 or 1-6 for 64K and 
256K expansions, 
{ bank address } Address within bank @ to 163 
C swap } ® oar omitted means act on present 
screen | means act on alternate 
screen, 


{ start location J] and € length } Define a block of original memory, 


C variable } Give the location of an integar 
variable to be assigned for example 
abe , 


3,14 Technical datails (hardware organisation) 


These interfaces add either a single block (64K) or four blocks (4 x 
64K) of RAM to an existing CPC464, 664 or 6128, 


Thus, if 64K fone block) is added to a 464, the total memory is two 
blocks, 128K, 


For a given set-up, calculate the total number of 64K blocks, this will 
determine which of the block select codes mentioned later are relevant 
to your system, The blocks are refferred to by number, block one is the 
original 64K, block two is equivalent to the second block Present in the 
6128, and so on, 


mL TET 
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Memory is actually switched in and out of the 64K 280 address space in 
16K subblocks (as are the ROMs), Which Particular combination of the 
original four 16K sub-blocks used, and any ‘new' sub-blocks from ram 
beyond the original 64K, is called the memory map, The map is 
determined by an 8-bit code byte sent to the gate array control port, 
&7F00, with the two top bits set to 1, The following description of the 
codes referes only to the remaining six bits, DS-De, 


Control Codes 

Bits D2-D® control the way 16K sub-blocks are arranged in the 230 memory 
space, bits DS5-03 control selection of whichever ‘new! 64K block is to 
be used, 


Bits D2-D@ - 16K Map Codes 
These bits select one of the eight fiaps into the 64K as follows:- 


CODE ® 1 2 3 4 5 & 7 
SUBBLOCK 

COOO-FFFF 3 3k 3 23% 3 3 3 3 
SO00@-BFFF 2 2 2% 2 2 2 2 2 
4000-7FFF 1 * 3 Ok 1% 2k oF 
0000-3FFF 8@ @ Ok @ @ @ @ B@ 


The numbers @, 1, 2, 3 refer to the four 16K sub-blocks in a 64K black 
in the obvious way, The star ¢k) indicates that the mamory i5 from a 
‘new' block, i@ block @ or higher, otherwise the ‘original’, block 1, is 
implied, 


Thus, code @ selects the original, unmapped 64K, code 2 selects a 
completely new black of 64k, the other codes are a mixture, 


Notes 
1, On power-up, code 6 is selected, 


2, The VOU circuitry always reads from the original 64K (block 1), 
independently af the code, 


3, If code 3 is used, reads from &4000 to &7FFF, on CPC 464 and 664 
machines, will only return the correct data if the upper ROM is 
disabled, This is at variance with CFC 6128 operation, but is 
unlikely to be a significant difference, 


4, If code 3 is used, addresses &4600 to AZFFF must not be used to run 
Programs, they are intended for VDU or data access only, 


—__—— 
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Bits DS-03, 64K Block Select Codes 


84 02 GLOCK 


r3) @ E (ie, ‘new’ memory sub-blacks came from block 2, as in CPC 


S 
an fe 


Which of the above codes are relevant to your machine depends on total 
namory (see previous remarks), 


Notes 


3, 


On power-up, code 6, @, @ is selected, 


Bits DS, D4, D3 above ‘count up' as blocks are selected, This may 
assist the programmer, 
If 2 K memory expanders are fitted to the machine, and option 


links are set appropriately, all patterns on DS-D3 can be used, 
giving a fiaximum of SISK extra memory, 


18 CUSTOMISING YOUR CP/M SYSTEM DISC 


Converting A 464 Keyboard Scan To That Of A 6128, 


The 
thinking that it is running on a 6128, 


Ve 


ams will not run correctly on the 464 computer because of 
“128 scans the keyboard, 


following program and instructions convert (fool), CPM+ into 


Make a working copy of both sides of your system disc (sides 1} and 


&) Use your standard CP/M 2,2 System disc and type 'ICPM', 


b) For Single drive systems use DISCCOPY, For dual drives use 
COFYDISC, (Remember to do both sides), 


c) Put your original system disc away in a safe place to keep as a 
back-up incase your working disc is damaged, 


Fut 'BANK' and ‘RSX' onto side | of the working disc, 
a) Follow the instructions in the manual to get a copy anto disc, 


Alternatively, use ‘FILECDPY BANE BAS' and 'FILECOPY RSX,BIN' if 
you have transferred the software to disc already, 
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Reset the machine, then enter CP/M+, Only one drive is necessary but 
if you have two you may wish to disconnect the second drive because 
all the changes are to be made on the working disc and with a single 
drive the computer can use both sides, 


a) RUN "BANK" then press <ENTER> in response to LOAD ADDRESS?, 


b>) Type in ‘TEMULATE:ICPM' then press <ENTER>, 


Type in the following, pressing <ENTER> after avery line unless 
atherwise written, Turn the disc aver when the computer asks:- 


ED PATCH, ASM 

i 

ORG 100H 

XRA A 

STA @FDEFH 

IMF 8 

END 

<CTRLO? do not press <ENTER> 
a 

EO PROFILE , SUB 

i 

PATCH 

<CTRLo?e do not press <ENTER> 
e 


(Insert disc containing MAC,COM FILE) 


B;MAC PATCH 
BsHEXCOM FATCH 
ERA PATCH, HEX 
ERA PATCH, SYM 
ERA PATCH, PRN 
ERA PATCH, ASM 


Tt is passible to alter the CF/M+ disc to boot up without loading the 
DE tronics BANK program first, Type the following if you want your 
system disc altered in this way:- 


ID ClOCPMS, EMS 


1E8 


do not press “ENTER? 
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256K SILICON DISC 


The 256K silicon disc is designed to be used with at least one normal 
disc drive attached, Data can be transferred onto the silicon dise from 
a normal disc, Application programs can then work on the data at vastly 
increased speed, especially on systems with only one normal drive, 
Support Software is contained in an expansion ROM, 


It is compatible with both DK'tronics 64k and 256K memory expansions, 
There are two environments in which to use the silicon disc: - 


1) From BASIC under AMSDOS, 
2) Within CP/M 2,2 or CP/M+, 


1) From BASIC: 


When the silicon disc is activated it will find out if there is a B 
drive or not, Using this information, the silicon disc is implemented as 
drive B or C, If there are two normal drives then an extra command 
'IC'is added, The silicon disc can then be accessed by logging on the 
drive by using {B or IC, Alternatively specifying the drive letter in a 
file name will have the same effect,The silicon disc will react as would 
normal Amstrad disc drives, 


At the start of a session using the computer, the data can be 
transferred to the silicon disc drive using the external command 
‘IDISCLOAD', When this data is updated it can be stored on the normal 
disc using the 'IDISCSAVE' command, 


Once the silicon disc has been initialised it accepts all the normal 
AMSDOS commands, (LOAD,SAVE,CAT and disc files etc), 


Even when the computer is reset (except by switching off the power) the 
contents of the silicon disc are kept intact, This means that it is 
possible to use CF/M and BASIC programs on the same data files without 
having to continually change discs, 


2) From CP/M 2,2 and CP/M ; 


The utility !SETDISC will write a COM file on a copy of your CP/M system 
disc, This program when called from CP/M will implement an additional 
drive as drive C, Using the SET.UP program you can get this program to 
run whenever you boot into CP/M, 


Once the drive is implemented, CF/M will treat it like the normal 
drive(s), Data can be transferred to and from the silicon disc via the 
PIP utility as normal, 


The silicon disc is especially useful for single drive CP/M systems as 
the disc containing the program is often nearly full and needs to stay 
in the drive, The silicon disc offers a cheap second drive for serious 
business applications, 


CP/M is «@ ragiatered tradeaark of Digital Reserch Inc, 
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256K SILICON DISC MANUAL 


WARNING 


Ensure that the power to your Amstrad computer is switched OFF before 
you fit the Silicon Disc to the expansion socket, Failure to comply 
with these instructions may cause permanent damage to the device or the 


computer, 


4,1 Installation 


This manual covers two versions of the silicon disc, one for the CPC 
464/664 and one for the CPC 6128, 


The software in ROM is compatible with the CPC 464, 664 and 6126 
machines, The case style for the CPC 6128 is the only difference 
between the two versions of Silicon Disc, All programs in this manual 
have been designed to run on the CPC 464 where the CPC 664 and CPC 6128 
are UPWARD compatible, You may however wish to use the extra features 
of the BASIC 1,1 machines, 


Fower down the computer and fit the Silicon Disc to the expansion socket 
on the rear of your Amstrad, On the CPC 464 this socket is labelled 
‘Floppy Disc', on the CPC 664 and CPC 6128 it is labelled ‘Expansion’, 
The Silicon Disc will only work in conjunction with the normal disc 
system, On the CFC 464 the FDI-1 needs to be fitted, Other expansions 
may be fitted into the expansion socket on the rear of the Silicon Disc, 
now switch on the computer, 


The computer should power up as normal, If it fails to do sa, check 

“that all the connections are correctly made, Note that all OK tronics 
products have a key location on the connector to ensure that there can 
be no alignment problems, OTHER interfaces may not use this keyway (the 
Amstrad disc interface is the most familiar example), Hence any 
connection problems will usually lie between the Silicon Dise and these 
expansions, If this is the case, try reconnecting the interfaces BEFORE 
inserting the Siliocn Dise onte the expansion slot, This will give you 
a better view when lining up the pins, 


Tf the computer DOES fail to power up due to misalignment problems the 
monitor may cut out the power to the computer unitl the MONITOR is 
switched off, This is not due to overload but is safety device built 
into the monitor to protect the computer and interfaces, On the colour 
manitor just switch the MONITOR off, reconnect the units as above, then 
switch on again, The monochrome monitor will have to remain switched 
off for quite a few seconds before the reset is Cleared, Reconnect as 
above, wait far a few seconds, then switch the monitor back on, 
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It is very unlikely that the computer (CPC 664 and CPC 6128) will fail 
to power up with the Silicon disc alone, If this is the case, then the 
fault will probably lie with the Silicon Disc, * Return the Unit to 
DE'tronics if this is the case, 


* IT IS ESSENTIAL THAT YOU COMPLETE YOUR WARRANTY REGISTRATION CARD AND 
RETURN IT TO US IMMEDIATELY UPON PURCHASING THIS PRODUCT FROM YOUR 
DEALER (UK ONLY?, 


4,2 FIRST STEPS 
When the computer is powered up the ROM should sign itself on as;—- 
‘Silicon Dise 1,1* 


The silicon disc requires a store of 456 bytes which are taken from the 
memory store before BASIC is entered, The Amstrad disc ROM must set up 
all the disc commands before the Silicon disc is started and so trying 
to access the silicon disc now will give an error of drive not present, 


Type 'tSDISC' and the computer will implement the silicon drive, 


Once the Silicon disc has been called an additional drive will be 
available to the system:- 


On a single drive system the drive is ‘B' 
On a dual drive system there is a new drive 'C' 


Try typing 'IB;CAT' or ‘IC:CAT', 


All the commands which are normally used in BASIC for the standard 
drives now apply also to the silicon disc, The only difference you 
should notice is the difference in access time for files and programs, 


When the computer is first switched on the Silicon Disc is empty, The 
catalog shows that there is 254K free, With 2k for the directory that's 
356K! Obviously that is not a lot of good, you want to put programs 
onto the silicon disc and take them off, 


There are two commands which allow bulk data to be moved from a normal 
disc (Drive A) to the silicon disc and vice-versa;— 


ILOADDISC Move normal disc's contents to silicon disc 
ISAVEDISC Put data back onto a normal disc 


The first command might be used at the start of a progamming session to 
move all your data to the silicon drive, The second would be used at. 
the end to move the data back to a normal disc, (Remember the contents 
of the silicon disc are lost if the computer is switched off!.) 
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The ‘tLOADDISC' command transfers ALL the files on the normal disc, 
With a maximum size of 178K you will never fill the Silicon Disc from a 
normal disc, ‘'ISAVEDISC' also transfers all the files but will not work 
if there is too much data on the silicon disc, Some BAK files etc will 
have to be removed first, If you wish to selectively save files it is 
best to use PIP in CP/M, 


Note that both the ILOADDISC and ISAVEDISC commands use BASIC memory to 
store the disc catalog so that the transfer is completed as fast as 
Possible, This means that BASIC programs are last, Hence both commands 
are best used before or after a programming session, 


Remember also that each disc copy will REPLACE the original contents of 
the drive you're copying to even if no files are present on the disc 
being copied, 


Once the silicon disc has some Programs on it, these can be loaded 
simply by using the standard LOAD and SAVE commands, Try loading some 
of your long programs from normal disc and then Silicon Disc to see the 
increase in speed, 


The {LOADDISC and ISAVEDISC commands automatically check whether you 
mind the BASIC area being used, If you respond with 'n' then they will 
abort back to BASIC, otherwise they will carry an, If, however, you add 
an optional parameter of 1 then the check will not be made and the 
commands will take action straight away, 


The ISAVEDISC command can also take a parameter of 2 which tells it to 
save all files onta a normal disc except the COM files, This is useful 
if you have too much data on the silicon disc so that it would fill the 
normal disc, You may not mind losing copies of your COM files as these 
are often stored seperately on your system, disc, 


4,3 COMPATABILITY 
BASIC programs using; ~ 
SAVE, LOAD, MERGE, CHAIN, RUN", CHAIN MERGE, CAT, OPENIN, OFENOUT, 

CLOSEIN, CLOSEOUT, INPUT #9, PRINT #5, LINE INPUT #9, WRITE #9, 

LIST #3, EOF 
Will function as normal, If the program was written to access only 
drive A then it will need to be altered to allow for drive B or c, 
Alternatively the drive letter could be specified:~ 

2g SAVE"C: PROGRAM] BAS" or RUN"B:- DEMO" 


All the standard external commands as supplied with AMSDOS will 
funciton:- 


1A, 1B, iC (dual drive only), IDISC ¢,IN and QUT), 
HTAPE ¢,IN and .QUT), ICPM, IDIR, IDRIVE, IERA, {REM, {USER 
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Typing IG or 18 will set the silicon disc as default and all the above 
commands will function on the silicon disc unless the drive letter is 
specified, 


The Silicon Disc will activate the Amstrad's error trapping if this is 
set up and the error number returned by DERR and ERR are the same, 


Some errors cannot accur oan the Silicean Disc:- 
DOERR = 149: Dise changed with files open 


and Drive; disc missing 
Drive: disc is write protected 
Drive: read fail 
Drive; write fail 


The silicon disc cannot be removed, so there is no problem with logging 
the disc in or writing files to it, Because the disc is RAM there can 
be no read or write errars, The normal disc drives will issue all the 
error messages that it normally does, 


The command ITAPE will switch in the tape unit as normal: {DISC will 
switch both the normal dise dirvels? and the silicon disc bank in, 


The filenames are identical for both normal and silicon drives, The 
system will default to BAS or ,BIN extensions where applicable, also 
.$$$ files are created before files are closed and ,BAK files for one 
level backup, 


4,4 USING YOUR SILICON DISC IN CP/M 2,2 


Before the silicon dise can be used under CP/M, the silicon disc program 
needs to be stored on a copy of your system disc, With the computer 
just powered up, and a copy of your system disc in drive A, If you have 
not already got a copy of your system disc to use them make a copy as 
described in Amstrad's manual ;— 


Type 'ISETCPM' and press <ENTER? 

The computer will write a file onto the system disc called 
'spIsc,COM’ 

Enter CP/M by typing 'ICPM' 

When the 'A>' prompt appears, type 'MOVCPM 176 %' then ‘SYSGEN *' 


This will move the top of CP/M down so that there 15 some spare memory 
for the program to use, This change will not affect the majority of 
your programs as the amount of memory used is so small, However the 
Amstrad DISCOPY, COPYDISC and other programs use the whole of the memory 
so it is best to keep an unaltered system disc for when you want to copy 
discs, The use of FIP is not affected so it is probably best to use PIP 
CILGADDISC and ISAVEDISC) in conjunction with the Silicon disc when you 
want to copy discs, 
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If you now type 'SDISC', the computer will start up with the Silicon 
disc, You da not need to type MOVCEM and SYGEN every time, just SDISC, 
The Silicon disc can be set to automatically start when you boot CPM:- 


Type ‘SETUP! and press <ENTER? 
The first question SETUP will ask is to set up the initial command 
buffer, Select 'n' option so that you can change the start up buffer, 
Now enter 'SDISCTM' the ‘T' will cause the computer to type the SDISC 
command whenever CFM is entered, Answer ‘y' to all the other questions 
and ‘y' to altering the system disc, Note that the ‘ft! key is located on 
the same key as the ‘£' key, 


The system disc is now finished, Try Resetting and booting CFM to see 
how it works, 


Once SDISC has been activated, an extra drive will be available as drive 
Boor C depending on whether you have a second normal drive, 


All the standard CPM programs will now use the silicon disc if you 
specify the silicon drive's letter, 

4,4,1 USING YOUR SILICON DISC IN CP/M PLUS 

Before the silicon disc can be used under CFP/M+ a Patch to the early 
morning start-up file €,ems) is required, This will support a RAM drive 
as C;, The following steps are necessary:- 


1) Create a new disk with a copy af the ems file 


2) From BASIC type in 'ISETCFM+' then press SENTER?, This will place a 
copy of the patcher.com file onto the disk, 


3) Boot CP/M+ using this disk in drive @: The new disk must have at 
least 25K free !, 

4) Immediately following the A> type 'patcher' then press <ENTER>, The 
Patcher program will now create 3a new version af the ens file 
erasing the old copy at the same time, 


5) Reboot CP/M+ using this new file, The silicon disc will now log on 
automatically as drive C:, 


The capacity of this disk will be one of the following ;- 
a) 130K - if only a 258K DK‘ tronics memory expansion is available, 


b) 254K ~ if only the DK'tronics silicon disc RAM is available, 
(compatible with current CF/M 2,2 version) 


ec) 444K - If both the OK tronics 255K hremory expansion and the silicon 
disc are available, 
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The new .ems file automatically works out how much extra RAM you have on 
the system and configures it accardingly. 

The RAM disk directory is automatically initialised to contain no files 
the first time this new ems file is run, However, if the files have 
been placed in the RAM disk on a previous occasion, the directory is not 
formatted, assuming the computer has not been switched off, This allows 
you to enter CP/M 2,2 or AMSDOS and then return to CP/M+ with your files 
still present in drive C:, 


4,5 ADVANCED NOTES 


Both under AMSDOS and CPM the individual file's write disable and system 
status are complied with, 


The use of the silicon disc from machine code can be easily implemented 
by using FAR calls to the external commands and by using the cassette 
calls as documented in the Amstrad manual, All the interfaces are the 
same 50 existing software sould run fine, The external commands which 
read and write to specific sectors, format and move the head on the 
normal two drives (CTRLA to CTRLL) will not function on the silicon 
drive and in fact may issue an error message that the drive is not 
present, Any direct reading and writing can be done by bank switching 
the 256K or memory into the memory map 16K at a time, 


The memory block from 16384 to 32767 is used to switch the RAM in and 
out of the memory map, The port location &7FOO is used to contrel the 
switching, There are 16 banks of 16K and the numbers to send to the 
port are as follows:~ 

228,229,230, 231,236,237, 238,239,244, 245,246,247, 252,255,254, 255 


There is a simple formula to calculate the corract value for the bank 
you want where BANK is a number @ to 15:- 


VALUE=228+ (BANK AND 3)+5:%(BANK/4) 


The first bank holds the catalog and the first 14 blocks of Ik, 
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